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CHAPTER  1  INTRODUCTION 


1.1  Background 

Management   of   a   bridge   system   involves   a   complex 

decision-making  process.   A  comprehensive  bridge  management 

system  provides  a  set  of  tools  and  techniques  that  aid  in  this 

process  by  selecting  improvement  projects,  estimating  repair 

costs,  prioritizing  projects,  and  so  on.   Such  a  system  has 

been  developed  for  the  Indiana  Department  of  Transportation 

(INDOT) ,  based  on  research  performed  by  the  Joint  Highway 

Research  Project  (JHRP)  at  Purdue  University.    For  more 

information  regarding  the  development  of  these  tools  and 

techniques,  refer  to  the  reports  titled,  "The  Development  of 

Optimal   Strategies   for   Maintenance,   Rehabilitation   and 

Replacement  of  Highway  Bridges,"  FHWA/IN/JHRP-89/8-13 ,  Volumes 

1-6.   The  titles  of  all  six  volumes  are  listed  below: 

Volume  1  Elements  of  Indiana  Bridge  Management  System 

Volume  2  A  System  for  Bridge   Structural   Condition 

Assessment 

Volume  3  Bridge  Traffic  Safety  Evaluation 

Volume  4  Cost  Analysis 

Volume  5  Priority  Ranking  Method 

Volume  6  Performance  Analysis  and  Optimization 


2 
1.2  Purpose  and  Scope  of  Research 

The  present  study  focused  on  the  implementation  of  the 
project  selection  module  of  the  Indiana  Bridge  Management 
System  (IBMS) .  The  project  selection  module  is  a  group  of 
decision-making  tools  originally  consisting  of  three  programs: 
life  cycle  model,  ranking,  and  optimization.  A  fourth  program 
has  been  added  to  the  IBMS,  DTREE,  which  utilizes  a  decision 
tree  to  select  projects  based  on  certain  traffic,  roadway,  and 
bridge  properties. 

The  purpose  of  this  study  was  to  provide  a  user's  manual 
for  running  the  IBMS  package  as  an  integrated  tool.  It  should 
be  noted  that  the  four  programs  are  to  be  run  sequentially. 
Once  the  decision  tree  identifies  the  possible  projects,  life 
cycle  costs  are  computed  by  the  economic  analysis  program.  At 
this  point,  a  decision  can  be  made  only  on  the  basis  of  cost 
effectiveness  values  generated  by  the  COST  program.  If  it  is 
desired  to  consider  additional  factors,  such  as  community 
impact  and  traffic  safety,  the  next  program,  RANK,  should  be 
used.  Similarly,  if  global  optimization  is  desired,  the 
fourth  program,  OPT,  should  be  run. 


1.3  Report  Organization 

This  report  consists  of  eight  chapters.    Chapter  2 

describes  the  four  programs.    Chapter  3  contains  basic 

hardware   requirements   and   instructions   regarding   the 

installation,  set  up,  and  running  of  the  IBMS.   Chapter  4 


3 
describes  "runfiles,"  which  control  option  settings  and  file 
names.  Chapter  5  explains  parameter  files,  which  allow  the 
user  and  the  IBMS  to  communicate  with  each  other.  Chapter  6 
provides  an  explanation  of  "exception  files,"  which  allow  the 
user  to  override  information  in  the  bridge  database  file. 
Chapter  7  describes  the  IBMS  Tools,  which  are  a  set  of  tools 
designed  to  make  the  IBMS  more  convenient  for  the  user. 
Chapter  8  provides  an  explanation  for  an  example  run  of  the 
IBMS  package.  The  appendices  contain  flow  charts  of  program 
operation,  file  formats,  sample  reports,  descriptions  of  the 
functions  and  subroutines  used  in  the  programs,  and  other 
information  which  may  be  useful. 


CHAPTER  2  PROJECT  SELECTION  MODULE 


2 . 1  Introduction 
The  Indiana  Bridge  Management  System  (IBMS)  consists  of 
four  stand-alone,  yet  interrelated  programs:  a  decision  tree 
program,  an  economic  analysis  program,  a  project  ranking 
program,  and  an  optimization  program.  To  obtain  a  full 
analysis,  the  programs  should  be  run  sequentially;  otherwise, 
unexpected  results  or  errors  may  occur.  A  flow  chart  of  the 
IBMS  is  illustrated  in  Figure  2.1. 


2.2  Decision  Tree  Program  (DTREE) 
The  Decision  Tree  Program  (DTREE)  is  the  first  program  in 
the  IBMS.  DTREE  analyzes  a  set  of  bridges  and  recommends  an 
action  for  each  bridge.  This  action  consists  of  three  basic 
choices:  do  nothing,  rehabilitation,  and  replacement.  These 
three  choices  can  be  broken  down  further  into  17  possible 
repair  types;  a  list  can  be  found  in  Figure  2.2  and  Appendix 
H. 

Decisions  are  based  on  bridge  condition  numbers  and 
bridge,   roadway,   and   traffic   characteristics,   such   as 
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Figure   2.1    IBMS   Operation 
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inventory  rating  and  vertical  clearance.  Condition  numbers 
rate  a  bridge's  deck,  substructure,  and  superstructure  on  a 
scale  of  0  to  9,  with  9  indicating  the  maximum  rating  for  a 
new  bridge  (Jiang  and  Sinha  1989) .  These  numbers  are  updated 
dynamically  using  the  Markovian  process  and  then  rounded  to 
the  nearest  integer.  Once  an  action  is  selected,  the  program 
also  estimates  the  repair  year  and  project  cost. 

Repairs  are  recommended  2,  3,  4  and  5  years  in  advance 
from  the  year  of  analysis,  since  this  is  a  typical  time  period 
for  programming  and  preliminary  engineering.  When  DTREE 
recommends  a  repair,  a  decision  code  is  saved  only  when  it 
occurs  for  the  first  time.  For  example,  if  the  analysis  year 
is  1992  and  DTREE  recommends  a  "do  nothing"  in  1994, 
rehabilitation  for  1995  and  1996,  and  a  replacement  in  1997, 
DTREE  would  only  save  the  decision  codes  for  1994,  1995,  and 
1997.  If  no  action  is  recommended,  the  action  year  is 
automatically  set  to  two  years  from  the  analysis  year; 
however,  this  action  will  not  be  processed  by  subsequent 
programs . 


2.2.1  Program  Operation 
The  flow  charts  found  in  Appendices  A  and  D  describe 
basic  program  operation.   A  decision  tree  used  to  recommend 
repairs  is  shown  in  Figure  2.2. 
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2.2.2  Input  Requirements 

2.2.2.1  Data  Files 

The  bridge  database  file  for  the  IBMS  is  created  by 
extracting  data  from  the  main  bridge  database  at  INDOT,  which 
is  collected  under  the  National  Bridge  Inventory  System 
(NBIS) .  This  file  must  conform  to  the  specified  format  found 
in  Appendix  F. 

Exception  files,  if  available,  are  processed  by  DTREE, 
which  in  turn  passes  this  information  to  subsequent  programs 
through  its  output  file;  refer  to  Appendix  F  for  more 
information.  Exception  files  allow  the  user  to  modify 
information  in  the  bridge  database,  and  thus,  override 
decisions  made  by  DTREE  and  influence  how  certain  actions  are 
performed,  such  as  bridge  widening.  These  files  are  not 
essential  for  normal  operation  of  the  system;  they  merely 
provide  additional  flexibility  and  control.  Refer  to  Chapter 
6  for  more  information  regarding  exception  files.  A  sample 
exception  file  can  be  found  in  the  directory  \bridge\examples. 


2.2.2.2  Runfile 

The  runfile  contains  all  the  information  regarding  option 
settings  and  input/output  file  names  used  by  the  IBMS.  A 
default  runfile  with  pre-defined  settings  is  loaded  upon 
program  execution;  however,  the  user  can  specify  a  runfile 
that  is  tailored  to  his/her  own  needs.    Runfile  options 
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pertaining  to  DTREE  include  the  following:  print  text 
reports,  Lotus  12  3  reports,  and  log  file,  check  bridge 
records,  report  style,  and  process  exception  files.  These 
options  are  explained  in  depth  in  Chapter  4.  A  copy  of  the 
runfile  can  be  found  in  the  directories  \bridge\run  and 
\bridge\examples . 


2.2.2.3  Parameter  Files 

Parameter  files  are  text  files  read  by  the  IBMS.  These 
files  allow  the  user  to  easily  modify  options,  equation 
constants,  weights,  conversion  factors,  etc.,  rather  than 
searching  through  the  source  code.  DTREE  uses  the  following 
parameter  files:  decision  tree,  cost,  and  dollar  conversion. 
Chapter  5  provides  an  in  depth  explanation  of  these  files. 


2.2.2.4  Keyboard  Input 

The  user  will  first  be  prompted  for  a  runfile  name.  The 
default  runfile  can  be  used  or  one  can  be  specified.  If  an 
external  runfile  is  used,  the  file  extension  (e.g.,  *.run) 
must  be  entered.  Next,  the  user  will  be  asked  for  the 
analysis  year  (four  digits) ,  the  report  style,  and  whether  or 
not  exceptions  will  be  used. 
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2.2.3  Output 

If  the  default  runfile  is  used,  the  program  creates  four 

report  files  called  dtree,  with  the  following  extensions: 

.txt,  .prn,  .out,  and  .log.   A  description  of  each  extension 

is  provided  below. 

•txt      program  report 

.prn      program   report,   set   off   by   commas   and 

quotation  marks  for  a  spreadsheet  program 
.out      bridge  information  read  by  subsequent  programs 
. log      record  of  program  execution 

The  user  can  choose  from  three  different  report  styles: 

normal,  condition,  and  exception.  The  normal  report  contains 

basic  information,  such  as  the  bridge  number  and  designation, 

route  number,  district  and  county  codes,  action  year  and  code, 

a  description  of  the  action,  estimated  cost,  whether  or  not 

exceptions  were  used,   and  the  total  number  of  projects 

selected  for  each  action.   The  condition  report  contains  the 

same  information  as  the  normal  report;  it  also  provides  the 

deck,  substructure,  and  superstructure  condition  numbers  for 

the  year  of  inspection,  as  well  as  for  analysis  year.   The 

exception  report  also  contains  the  same  information  as  the 

normal  report,  but  also  includes  exception  file  data.   Note 

that  if  exceptions  are  not  used,  these  columns  will  be  filled 

with  values  of  zero.   Samples  of  the  reports  and  log  file  can 

be  found  in  Appendix  G;  a  sample  output  file  can  be  found  in 

Appendix  F. 
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2.3  Cost  Estimate  Program  (COST) 
Once  the  initial  investment  is  made  to  construct  a 
bridge,  future  funding  needs  must  also  be  analyzed,  since  a 
bridge  represents  a  long-term  investment.  The  Economic 
Analysis  Program  (COST)  is  the  second  program  in  the  IBMS. 
This  program  performs  a  life  cycle  cost  analysis  for  each 
bridge,  estimating  maintenance,  rehabilitation,  and 
replacement  costs  over  the  life  of  a  bridge.  If  no  repair  is 
recommended  by  DTREE  (action  code  0) ,  COST  will  not  perform  a 
life  cycle  cost  analysis. 

To  compare  the  costs  of  different  projects  on  an  egual 
basis,  these  costs  are  converted  to  an  equivalent  uniform 
annual  cost  (EUAC)  in  perpetuity.  A  cost  effectiveness  factor 
(CEF)  is  then  calculated,  based  on  ADT,  EUAC,  and  deck  area. 
This  factor  serves  as  a  normalizing  factor,  so  that  bridges 
with  different  characteristics  and  service  levels  can  be 
compared. 


2.3.1  Program  Operation 
The  flow  charts  found  in  Appendices  B  and  D  describe 
basic  program  operation.  Derivations  for  cost  equations  can 
be  found  in  the  report,  FHWA/IN/JHRP-89/11,  "The  Development 
of  Optimal  Strategies  for  Maintenance,  Rehabilitation  and 
Replacement  of  Highway  Bridges,  Final  Report  Vol.  4:  Cost 
Analysis"  (Saito  and  Sinha  1989) . 
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2.3.2  Input  Requirements 


2.3.2.1  Data  Files 

An  output  file  from  DTREE  provides  the  bridge  number, 
projects  selected,  exceptions  used,  and  other  information;  see 
Appendix  F  for  a  complete  description.  Once  the  bridge  number 
is  known,  other  information,  such  as  length  and  width,  is 
found  by  locating  the  bridge  record  in  the  bridge  database 
file.  The  same  database  file  and  runfile  used  by  DTREE  must 
be  used  in  COST;  otherwise,  unexpected  results  or  errors  may 
occur.  In  addition,  the  same  analysis  year  should  be 
specified. 


2.3.2.2  Runfile 

Options  similar  to  those  mentioned  in  Section  2.2.2.2  are 
available  in  COST.  In  addition,  the  user  also  has  the  option 
to  calculate  maintenance  costs  and  lengthen  and  widen  bridges; 
refer  to  Figure  4.1,  lines  17  through  19,  for  more 
information. 


2.3.2.3  Parameter  Files 

The  following  parameter  files  are  used  by  COST:  cost, 
life  cycle  model,  and  dollar  conversion.  Chapter  5  provides 
an  in  depth  explanation  of  these  files. 
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2.3.2.4  Keyboard  Input 

The  user  will  be  prompted  for  a  runfile  name.  The 
default  runfile  can  be  used  or  one  can  be  specified.  If  an 
external  runfile  is  used,  the  file  extension  (e.g.,  *.run) 
must  be  entered.  Next,  the  user  will  be  asked  for  the 
analysis  year  (four  digits) ,  the  report  style,  and  whether  or 
not  exceptions  will  be  used. 


2.3.3  Output 
If  the  default  runfile  is  used,  the  program  creates  four 
report  files  called  cost,  with  the  following  extensions: 
.txt,  .prn,  .out,  and  .log.  The  user  can  choose  from  four 
different  report  styles:  normal,  look  ahead,  present  worth, 
and  present  worth  look  ahead.  The  normal  report  contains 
basic  information,  such  as  the  bridge  number  and  designation, 
route  number,  district  and  county  codes,  action  year  and  code, 
a  description  of  the  action,  estimated  cost,  EUAC,  CEF, 
whether  or  not  exceptions  were  used,  and  total  and  average 
project  costs.  The  look  ahead  report  contains  the  same 
information  as  the  normal  report,  but  also  estimates  future 
repairs  and  their  costs.  The  present  worth  and  present  worth 
look  ahead  reports  calculate  the  present  worth  for  projects. 
Samples  of  the  reports  and  log  file  can  be  found  in  Appendix 
G;  a  sample  output  file  can  be  found  in  Appendix  F. 


14 
2.4  Project  Ranking  Program  (RANK) 

The  Project  Ranking  Program  (RANK)  is  the  third  program 
in  the  IBMS.  This  program  computes  the  total  disutility  for 
a  bridge,  based  on  the  following  criteria:  cost 
effectiveness,  bridge  condition,  safety,  and  community  impact. 
These  four  criteria  are  measured  by  seven  utility  functions, 
which  are  then  weighted  and  added  together  to  form  the  total 
disutility,  which  ranges  from  0  to  100.  A  score  of  0 
indicates  that  the  bridge  is  in  near  perfect  condition,  while 
100  signifies  that  the  bridge  requires  immediate  repair.  Once 
the  disutility  is  computed  for  each  bridge,  the  projects  can 
be  prioritized.  See  Figure  2.3  for  a  breakdown  of  the  ranking 
process. 


2.4.1  Program  Operation 
The  flow  charts  found  in  Appendices  C  and  D  describe 
basic  program  operation.  A  detailed  analysis  of  the  ranking 
procedure  can  be  found  in  the  report,  FHWA/IN/JHRP-89/12 ,  "The 
Development  of  Optimal  Strategies  for  Maintenance, 
Rehabilitation  and  Replacement  of  Highway  Bridges,  Final 
Report  Vol.  5:  Priority  Ranking  Method  (Saito  and  Sinha  1989) . 
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2.4.2  Input  Requirements 


2.4.2.1  Data  Files 

An  output  file  from  COST  provides  the  bridge  number, 
project  costs,  and  other  information;  see  Appendix  F  for  a 
complete  description.  Once  the  bridge  number  is  known, 
other  information,  such  as  length  and  width,  is  found  by 
locating  the  bridge  record  in  the  bridge  database  file.  The 
same  database  file  and  runfile  used  by  DTREE  must  be  used  in 
RANK;  otherwise,  unexpected  results  or  errors  may  occur.  In 
addition,  the  same  analysis  year  should  be  specified. 


2.4.2.2  Runfile 

Options  similar  to  those  mentioned  in  Section  2.2.2.2  are 
available  in  RANK. 


2.4.2.3  Parameter  Files 

The  following  parameter  files  are  used  by  RANK:  ranking 
weight  and  ranking  utility.  Chapter  5  provides  an  in  depth 
explanation  of  these  files. 


2.4.2.4  Keyboard  Input 

The  user  will  be  prompted  for  a  runfile  name.    The 
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default  runfile  can  be  used  or  one  can  be  specified.  If  an 
external  runfile  is  used,  the  file  extension  (e.g.,  *.run) 
must  be  entered.  Next,  the  user  will  be  asked  for  the 
analysis  year  (four  digits)  and  the  report  style. 


2.4.3  Output 
If  the  default  runfile  is  used,  the  program  creates  four 
report  files  called  rank,  with  the  following  extensions: 
.txt,  .prn,  .out,  and  .log.  The  user  can  choose  from  two 
different  report  styles:  normal  and  utility.  The  normal 
report  contains  basic  information,  such  as  the  bridge  number 
and  designation,  route  number,  district  and  county  codes, 
action  year  and  code,  a  description  of  the  action,  estimated 
cost,  EUAC,  whether  or  not  exceptions  were  used,  total 
disutility  before  and  after  a  repair  is  made,  the  change  in 
disutility,  and  the  number  of  projects  selected.  The  utility 
report  contains  the  same  information  as  the  normal  report,  but 
also  includes  the  disutility  values  for  each  disutility 
function.  Samples  of  the  reports  and  log  file  can  be  found  in 
Appendix  G;  a  sample  output  file  can  be  found  in  Appendix  F. 


2.5  Optimization  Program  (OPT) 
The  effectiveness  of  a  projecc  is  judged  by  the  expected 
difference  in  disutility  before  and  after  a  repair  is 
implemented.     The   fourth  program   in  the   IBMS   is  the 
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Optimization  Program  (OPT) ,  which  applies  integer  linear 
programming  to  select  projects  over  a  four-year  period.  The 
objective  function  is  to  maximize  the  change  in  disutility 
subject  to  available  funding.  Funding  levels  are  specified  by 
the  user. 


2.5.1  Program  Operation 
A  description  of  basic  program  operation  can  be  found  in 
Appendix  E.  A  detailed  analysis  of  the  optimization  procedure 
can  be  found  in  the  report,  FHWA/IN/JHRP-89/13 ,  "The 
Development  of  Optimal  . Strategies  for  Maintenance, 
Rehabilitation  and  Replacement  of  Highway  Bridges,  Final 
Report  Vol.  6  (Jiang  and  Sinha  1989) . 


2.5.2  Input  Requirements 

2.5.2.1  Data  Files 

An  output  file  from  RANK  provides  the  bridge  number, 
disutilities,  and  other  information;  see  Appendix  F  for  a 
complete  description.  Once  the  bridge  number  is  known,  other 
information,  such  as  length  and  width,  is  found  by  locating 
the  bridge  record  in  the  bridge  database  file.  The  same 
database  file  used  by  DTREE  must  be  used  in  OPT;  otherwise, 
unexpected  results  or  errors  may  occur.  In  addition,  the  same 
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analysis  year  should  be  specified. 


2.5.2.2  Runfile 

A  runfile  is  not  used  by  OPT.   Instead,  input  is  manually 
entered  by  the  user. 


2.5.2.3  Parameter  Files 

Parameter  files  are  not  used  by  OPT. 


2.5.2.4  Keyboard  Input 

The  user  will  be  prompted  for  the  analysis  year  (four 
digits) ,  each  optimization  year  (four  digits) ,  and  the  yearly 
budget  (in  thousands  of  dollars) . 


2.5.3  Output 
The  program  outputs  a  year  by  year  listing  of  the 
selected  projects,  one  for  each  year  in  the  analysis  period. 
These  listings  are  in  COST  output  format  and  are  CH0SEN_1.0UT, 
CH0SEN_2.0UT,  CH0SEN_3 .OUT,  and  CH0SEN_4 .OUT.  Figures  8.22- 
8.2  4  show  an  example  of  this  report. 
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2 . 6  Code  Mapping 


2.6.1  Introduction 

All  data  found  in  the  bridge  database  file  conforms  to 
the  standards  specified  in  the  Federal  Highway 
Administration's  (FHWA)  "Recording  and  Coding  Guide  for  the 
Structure  Inventory  and  Appraisal  of  the  Nation's  Bridges," 
December,  1988.  The  IBMS  converts  these  FHWA  codes  to  a 
simplified  set  of  internal  codes  to  enable  faster  processing. 
For  example,  the  functional  class  of  a  bridge  determines  which 
decision  tree  DTREE  uses  to  recommend  a  project.  The 
Recording  and  Coding  Guide  includes  approximately  ten 
different  functional  classes;  however,  it  is  impractical  to 
have  a  different  decision  tree  for  each  functional  class. 
Therefore,  the  codes  are  divided  into  two  groups:  major  and 
minor  highways.  A  similar  process  is  carried  out  for  other 
fields  in  the  bridge  database.  Table  2.1  provides  a 
description  of  these  mapped  codes. 

When  a  bridge  record  is  read  from  the  bridge  database 
file,  the  data  is  stored  in  memory.  Therefore,  when  the 
record  is  mapped,  the  codes  stored  in  memory  are  replaced  by 
the  appropriate  values;  data  from  the  original  file  remains 
unchanged. 

Some  fields  in  the  bridge  database  record,  such  as 
vertical  clearance  and  approach  length,  are  assigned  default 
values,  since  measurements  may  be  unavailable  from  field 
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Table  2 . 1  Mapped  Bridge  Fields 


Bridge  Field 

Recording 

and  Coding 

Guide  Item 

# 

Happed  Code' 

Original 
Code( s)' 

Purpose 

Functional 
Class 

26 

1 :  Major  highway 
2:  Minor  highway 

o  1,2,7,11,12,14 
o  6,8,9,16,19 

select  decision 
tree2,  maintenance 
cost  formula3; 
estimate  repair 
costs4;  update 
condition  numbers5 

Vertical 
Clearance 

54a  and  54b 

Default  or  Exception 
Value 

0'  0",  if  bridge 
is  over  water  or 
actual  value  in 
database  if  over 
road  or  rai I  road 

select  repair2;  cost 
calculations4; 
traffic  safety 
factor8 

Superstructure 
Material 

43a 

1:  Steel 
2:  Concrete 

o  3,4,9 

o  1,2,5.6,7,8,0 

select  life  cycle 
model3;  estimate 
repair  costs4; 
select 
superstructure  type 

Superstructure 
Type 

43b 

1:  RC  slab  and  Box 

beam 

2:  Concrete  I-beam 

3:  Steel  beam 

4:  Steel  girder 

o  1,5,6,20,0 

o  4,8,11,12,18, 

19,22 

o  15,16,17 

o  2,3,7,9,10,13. 

14,21 

calculate 

superstructure 

costs4 

Approach 
Length 

Not 

avai I  able 

Default  or  Exception 
Value 

Not  available 

calculate  approach 
costs4 

Refer  to  bdata.for  and  map. for  for  more  information. 

2  Refer  to  Chapter  5,  Section  2. 

3  Refer  to  Chapter  5,  Section  4. 

4  Refer  to  costest.for.  Appendix  H,  and  FHWA/IN/JHRP-89/11  (Saito  and  Sinha  1989)  for  more  information. 

5  Refer  to  degrade. for  and  FHWA/IN/JHRP-89/13  (Jiang  and  Sinha)  for  more  information. 

6  Refer  to  Chapter  5,  Sections  5  and  6. 
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inspections.  These  values  are  assigned  at  the  same  time  that 
the  FHWA  codes  are  converted  to  their  internal  values. 

2.6.2  Viewing  Mapped  Codes 

The  user  can  examine  the  mapped  code  values  by  printing 
the  bridge  database  file  with  a  program  (PRBRIDGE.EXE)  found 
in  IBMS  Tools.  This  program  creates  a  text  file  so  that  the 
user  can  view  the  file  with  its  original  codes  or  with  the 
mapped  codes.  These  two  reports  can  then  be  compared  to  see 
the  original  and  mapped  codes. 

The  user  also  has  the  option  to  check  the  database  file 
for  errors.  Fatal  errors  occur  when  a  bridge  record  contains 
bad  or  missing  data,  such  as  condition  numbers,  needed  for 
program  calculations.  Any  record  with  one  or  more  fatal 
errors  will  be  rejected  and  an  error  message  will  be  printed. 
Nonfatal  errors  occur  when  data  does  not  conform  to  the  NBIS, 
but  does  not  affect  program  operation.  Refer  to  Chapter  7  for 
more  details. 
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CHAPTER  3  RUNNING  THE  IBMS 


The  Indiana  Bridge  Management  System  (IBMS)  runs  on  an 
IBM-compatible  computer  system.  The  IBMS  package  was 
developed  using  IBM  FORTRAN/ 2,  under  the  IBM  Operating 
System/2  (OS/2),  Standard  Edition  1.3.  The  IBMS  Tools, 
explained  in  Chapter  7,  were  written  in  Microsoft  C. 
Compatibility  problems  of  IBM  FORTRAN/ 2  with  OS/2  2.0  reguire 
a  DOS  window  for  executing  DTREE,  COST,  and  RANK.  The 
included  source  listings  of  DTREE,  COST,  and  RANK  were 
compiled  and  executed  on  FORTRAN/2  with  OS/2  1.3.  Check  for 
compatibility  with  individual  systems. 


3 . 1  Hardware  Requirements 
To  run  the  IBMS,  the  following  eguipment  is  necessary: 
a  386  IBM-compatible  computer  with  a  20  megahertz  processor, 
4  megabytes  (MB)  of  available  memory  (RAM),  and  80  MB  of  hard 
drive  space.  While  the  actual  IBMS  only  requires  about  3  MB 
of  hard  drive  space,  the  commercial  software  packages  (OS/2, 
Microsoft  C,  and  IBM  FORTRAN/ 2)  require  hard  drive  space  on 
the  order  of  3  0  to  60  MB. 
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3 . 2  Software  Requirements 
In  order  to  run  the  IBMS,  OS/2  must  be  present  on  the 
computer.  If  the  user  plans  to  modify  the  source  code,  IBM 
FORTRAN/ 2,  and  Microsoft  C,  version  6 . 0  or  greater,  must  also 
be  installed.  To  fully  utilize  the  capabilities  of  the  IBMS, 
the  user  may  wish  to  install  a  spreadsheet  program,  such  as 
Lotus  12  3,  to  view  reports  with  the  .prn  extension. 
In  addition,  a  word  processor,  such  as  Word  Perfect,  may  be 
useful  so  that  the  reports  can  be  printed. 


3.3  Installing  the  IBMS 

Prior  to  installation  of  the  IBMS,  the  CONFIG.SYS  file 

must  include  the  following  statements  so  that  the  programs  run 

properly: 

LIBPATH=c: \fortran;c: \; 

SET   PATH=c: \c600\binp; c: \c600\binb;c : \fortran;c: \bridge\prog;c: \ ; 

SET   DPATH=c: \c600\binp; c : \c600\binb; c : \f ortran; c: \bridge\prog;c: \ ; 

Furthermore,    a  file  called  STARTUP.CMD,   which  is  placed  in  the 

root  directory,    should  contain  the  following  information   (IBM 

1987)  : 

rem  FORTRAN  Options 
rem  ============ 

SET  FORTRAN. CER=C: \ FORTRAN \ FORTRAN. CER 
SET  FORTRAN. DER=C:\ FORTRAN \ FORTRAN. DER 
S  ET  FORTRAN . ERR=C : \ FORTRAN \ FORTRAN . ERR 
SET  FORTRAN . HLP=C : \ FORTRAN \ FORTRAN . HLP 
rem  C  Options 
rem  ======== 

set  INCLUDE=c:\C600\INCLUDE 

set  HELPFILES=c:\C600\HELP\*.hlp 

set  INIT=c: \c600\INIT 
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set  TEMP=c:\TMP 

SET  LIB=C: \FORTRAN\PLIB;C: \C600\LIB 

exit 

Copies  of  these  files  can  be  found  in  the  \bridge\setup 

directory  on  the  installation  disk.    Consult  the  README 

documentation  file  in  the  \bridge\setup  directory  for  complete 

setup  instructions. 

To  install  the  IBMS,  insert  the  first  installation  disk. 

Type  "cd  \"  at  the  c:  prompt  to  return  to  root  directory.  The 

prompt  should  now  read  c:.   To  install  the  programs,  type 

"a:\unzip.exe  a:\programs.zip".   Repeat  the  above,  replacing 

programs.zip  with  fortran.zip,  clang.zip,  emx_dll.zip  each 

time.  The  second  diskette  gets  installed  similarly,  replacing 

programs.zip  with  apps_os2.zip,  viewer.zip,  and  config.zip. 

The  third  diskette  contains  runfiles,  data  files,  exception 

files,  and  IBMS  tools.  To  properly  place  them,  it  is  required 

that   the   user   create   the   directories   \bridge\run, 

\bridge\bridge,  and  \bridge\reports.  The  user  can  then  place 

these  files  in  the  appropriate  directories. 

3.4  Setting  Up  the  IBMS 
Once  the  files  are  installed,  icons  can  be  created  to 
execute  DTREE,  COST,  RANK,  and  OPT  from  the  \bridge\prog 
directory.  See  Table  3.1  for  the  location  of  the  four 
programs.  To  install  icons  for  the  utility  programs  used  for 
viewing  the  OPT  reports,  follow  this  procedure  to  create  a 
icon  for  RANK_1.0UT  (for  OS/2  2.0): 
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Table  3 . 1  IBMS  Set-up  Procedure 


=-cgraa  f't.e 

Path  and  File  name           !'     ^arame-ecs              Mcrking 

;   -szzz- 

Program 
type 

;=c""s;3r  ~~ee  z-~Qsm 

\zr-zvzs  .;r;c  "-se.exe                                               :r;cce\-jr 

ce-au.t 

z  zzrom ;  z  i-~a .  >  s ;  s  -~zc  -am 

;r;2ge  ^rcc  zzsz.sxs                                                 cr:ace  ~-r 

oefsc: 

--z_sc:  Jar*-"-?  :-cc-=fn 

rr;cce  _^r;c  .rarac.sxe 

; i- :  :ce  ~_r 

3e*=k-wt 

Cc""' ii •';=-•' or  --sc-am 
: 

;r;3ce  prcc  .icz.mc 

cr;ace  ,-'j- 

3e-=>_.- 

•  :   --inns:  or   =  -e-scec  -;r  :■  =  ve.a. 
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3.5  Rur.r.ir.c  the  I5M5  frcm  the  Zccr.   View 

1.  Double  click  left  nouse  button  on  template  folder. 

2.  Double  click  left  ar.d  drag  f elder  with  right  iruttcr. 
to  make  the  IBMS  window. 

3 .  Double  click  right  and  drag  program  template  into 
window. 

4.  In  the  program  template,  click  once  on  the  right 
button.   Click  once  on  the  arrow  tc  the  right;  sice  cf  rear.. 
Click  right  once  on  settings. 

5.  Type  under  path  and  file  name: 
c:\BRIDGE\VIEWER\BIN\VIEWER.EXE 

6.  Type  (as  1  line)  under  optional  parameters: 
— rankf ile  c: \bridge\reports\rank_l .prn (space) 

c: \bridge\viewer\bin4RANK.cfg (space) 
c : \bridge\reports\rank_l . prn ( space) 
c: \bridge\viewer\bin\4RANKlotus.cfg 

7.  Under  working  directory: 
c: \bridge\viewer\bin 

Follow  same  procedure,  successively  replacing  RANK_1.PRN 
WITH  RANK_2.PRN,  RANK_3.PRN,  and  RANK_4.PRN.   For  further 
information  on  icons  and  OS/2  windows,  consult  the  IBM  OS/2 
Standard  Edition. 

To  install  icons  for  CH0SEN_1.0UT,  CHOSEN_2 .OUT, 
CHOSEN_3.0UT,  and  CH0SEN_4 . OUT ,  replace  step  6  with 
— costfile\bridge\reports\chosen_l. out (space) 
c: \bridge\viewer\bin\4COST. cfg(space) 
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c : \bridge\reports\chosen_l . prn (space) 
c : \bridge\viewer \bin\4C0STlotus . cf g 

Once  the  programs  are  added  to  the  program  group,  the 
IBMS  is  ready  to  run  from  the  OS/2  Icon  View. 

3.5.1  DTREE 
In  the  Icon  view,  move  the  mouse  pointer  to  DTREE  and 
double-click.  A  full  screen  will  appear,  asking  the  user  for 
a  runfile  name.  The  default  runfile  can  be  used  or  one  can  be 
specified.  Be  sure  to  type  in  the  file  extension  (e.g., 
*.run).  Next,  enter  the  analysis  year  (typically,  the  current 
year) ,  the  report  style,  and  whether  or  not  exceptions  will  be 
used.  For  more  information  on  customizing  a  runfile,  see 
Chapter  4.  After  program  execution,  an  output  file  (.out)  is 
created,  which  passes  on  the  necessary  information  needed  by 
the  next  program. 

3.5.2  COST 
Return  to  the  Icon  View  and  double-click  the  COST 
program.  The  user  will  be  prompted  for  the  runfile  name;  the 
same  runfile  specified  for  DTREE  should  be  used  or  unexpected 
results  or  errors  may  occur.  Next,  enter  the  analysis  year, 
the  report  style,  and  whether  or  not  exceptions  will  be  used. 
After  program  execution,  an  output  file  (.out)  is  created, 
which  passes  on  the  necessary  information  needed  by  the  next 
program. 
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3.5.3  RANK 
Again,  return  to  the  Icon  View  and  double-click  the  RANK 
program.  Enter  the  runf ile  name  (the  same  as  DTREE  and  COST) , 
analysis  year,  and  report  style.  After  program  execution,  an 
output  file  (.out)  is  created,  which  passes  on  the  necessary 
information  needed  by  the  next  program. 


3.5.4  OPT 
Double-click  the  OPT  program  in  the  Icon  View.  After  the 
first  prompt,  enter  the  analysis  year.   After  each  successive 
prompt,  enter  the  optimization  year  and  its  budget,  beginning 
2  years  after  the  analysis  year. 


3.6  Running  the  IBMS  from  the  OS/2  Prompt 
To  execute  the  IBMS  from  the  OS/2  prompt,  the  user  must 
be  in  the  following  directory:  \bridge\prog.  Type  "dtree", 
"cost",  "rank",  or  "optimize".  The  user  will  then  be  prompted 
for  the  runf ile,  analysis  year,  report  style,  and  whether  or 
not  exceptions  will  be  used.  When  prompted  for  the  runf ile, 
the  entire  path  name  must  be  specified.  For  example,  type 
c:\bridge\run\runfile.run;  otherwise,  an  error  will  occur  and 
the  program  will  stop.  An  example  run  is  provided  in  Chapter 
8,  along  with  an  explanation  of  the  results. 
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3.7  Viewing  and  Printing  Reports 

Each  program  (except  OPT)  generates  a  series  of  files 

with  the  following  extensions:  .txt,  .prn,  .out,  and  .log.  As 

OPT  is  the  final  program,  it  generates  only  a  year  by  year 

listing  of  the  selected  projects  and  is  not  required  to 

provide  any  information  in  addition  to  the  other  reports.  See 

Figure  8.22  through  8.24  for  OPT  output.   A  description  of 

each  file  extension  is  provided  below. 

.txt      program  report 

.prn      program   report,   set   off   by   commas   and 

quotation  marks,  for  a  spreadsheet  program 
. out      bridge  information  read  by  subsequent  programs 
. log      log  of  program  execution 

To  view  the  results,  double-click  on  the  IBMS  Tools 
option  and  then  double-click  on  the  View  Reports  option  under 
the  Icon  View  window.  Type  in  the  name  of  the  report,  for 
example,  DTREE.TXT  or  DTREE.LOG.  This  option  calls  up  a 
program  called  LIST. EXE,  which  is  a  read-only  program  that 
allows  the  user  to  view  the  contents  of  an  ASCII  file.  This 
program  is  configured  to  read  files  in  the  \bridge\reports 
directory;  if  the  user  wishes  to  view  a  file  in  another 
directory,  simply  type  the  full  path  name,  for  example, 
c: \bridge\bridge\bridge.dat. 

Another  alternative  would  be  to  import  a  .prn  report  into 
Lotus  12  3  or  a  compatible  spreadsheet  program.  In  Lotus  12  3, 
import  the  file  as  numbers;  in  Quattro  Pro,  import  as  a  comma - 
and-quote  delimited  file.  The  other  files  (.txt,  .out,  and 
.log)  can  also  be  imported  into  Lotus  123,  but  as  text, 
instead  of  numbers;  in  Quattro  Pro,  import  as  an  ASCII  text 
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file.  All  three  file  types  can  be  printed  within  the 
spreadsheet  program.  To  import  OPT  output  files  into  the 
spreadsheet  program,  see  Section  3.4. 

In  addition  to  printing  reports  from  a  spreadsheet,  the 
user  can  also  use  the  Print  Manager,  found  in  OS/2;  for  more 
information,  refer  to  "IBM  Operating  System/ 2  Standard  Edition 
Version  1.3  Getting  Started,"  Chapter  6.  Reports  can  also  be 
imported  into  a  word  processing  program. 
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CHAPTER  4  RUNFILES  AND  PROGRAM  OPERATION 


4.1  Introduction 
To  provide  flexibility,  the  IBMS  offers  a  variety  of 
options  which  control  program  operation.  Rather  than  entering 
these  options  each  time  a  program  is  executed,  the  system  uses 
a  special  input  file  called  a  "runfile,"  which  centralizes  all 
option  settings  and  file  names  used  by  the  programs.  Hence, 
minor  changes  can  be  made  to  the  runfile  without  having  to 
reenter  the  data  each  time  a  program  is  executed.  This  file 
can  be  found  in  the  following  directories:  \bridge\run  and 
\bridge\examples . 


4.2  Default  and  User  Defined  Runfile 
Each  of  the  main  programs  in  the  IBMS  is  compiled  with  a 
set  of  predefined  runfile  values,  which  are  initialized  at  the 
beginning  of  program  execution.  When  a  program  is  run,  the 
user  is  prompted  for  a  runfile  name.  If  "default"  or 
"runfile. run"  is  entered,  the  predefined  values  are  used  and 
no  external  disk  file  is  read.  However,  if  a  name  other  than 
"default"  or  "runfile. run"  is  entered,   the  program  will 
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attempt  to  open  and  read  a  runfile  from  disk,  which  will 
replace  some  or  all  of  the  default  runfile  information.  If 
any  errors  occur  when  reading  this  file,  the  program  will  stop 
since  it  is  impossible,  or  at  least  unwise,  to  continue  with 
bad  or  missing  runfile  information.  The  file  extension  must 
be  specified  when  a  runfile  other  than  the  default  is  used. 

To  customize  a  runfile,  duplicate  the  default  runfile, 
found  in  the  directory  \bridge\run  or  \bridge\examples,  make 
the  desired  changes,  and  save  the  file  under  a  different  name. 
For  example,  the  user  may  wish  to  use  a  bridge  database  file 
called  TEST. DAT  in  the  runfile,  rather  than  BRIDGE.DAT,  which 
is  the  default  name.  Thus,  modify  the  runfile  by  using  a  text 
editor,  such  as  the  OS/2  System  Editor,  or  a  word  processor, 
and  type  "test.dat"  in  the  appropriate  place. 


4.3  File  Layout 

A  runfile  is  divided  into  two  main  sections:  1)  option 
settings  and  2)  input,  output,  and  parameter  files.  The 
option  settings  control  program  operation,  such  as  report 
style,  and  consist  of  a  series  of  yes/no  questions  for  each 
program.  Reserved  fields  are  provided  for  future  programs. 
Each  option  has  a  one-character  field;  if  more  than  one 
character  is  entered,  only  the  first  one  is  read,  while  the 
rest  are  ignored.  Note  that  all  entries  for  option  settings 
must  be  in  lowercase  letters. 

The  second  section  of  the  runfile  contains  the  names  of 
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input,  output  and  parameter  files.  These  names  may  have  up  to 
eight  characters,  with  a  three  character  extension.  Each  file 
can  be  found  in  a  specific  directory;  therefore  the  full  path 
name  should  not  be  specified.  See  Table  4.1  for  more  details. 
File  names  are  case  insensitive;  i.e.,  upper  or  lowercase  can 
be  used.   Table  4.2  provides  an  explanation  of  the  runfile. 
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Table  4.1  File  Specifications 


File(s) 

Directory 

Extension 

Default  name(s) 

Bridge  Database 

\BRIDGE\BRIDGE 

*.dat 

bridge.dat 

Bridge  Index' 

\BRIDGE\BRIDGE 

*.inx 

bridge. inx 

Runf i le 

\BRIDGE\RUN 

*.run 

runf i le.run 

Except  i  on2 

\BRIDGE\RUN 

*.exp 

except. exp 
except2.exp 

Parameter3 

\BRIDGE\PARAM 

*.par 

dtree.par 

cost. par 

life. par 

dol lar.par 

weight. par 

uti lity.par 

Output 

\BRIDGE\REPORTS 

*.out" 

dtree.out 

cost. out 

rank. out 

chosen_1 . out 

chosen  4. out 

Reports 

\BRIDGE\REPORTS 

*.txt56 
*.prn" 

dtree.txt 
dtree.prn 
cost.txt 
cost.prn 
rank.txt 
rank.prn 

Log 

\BRIDGE\REPORTS 

*.log5a 

dtree. tog 
cost. log 
rank. log 

This  field  is  ignored  in  the  current  IBMS;  future  versions  may  use  this  field  to  allow  random  access 
of  bridge  records. 

2  See  Chapter  6  for  more  information. 

3  See  Chapter  5. 

*.out  files  provide  information  read  by  the  programs.  See  Appendix  F  for  examples. 

5  See  Appendix  G  for  examples. 

6  *.txt  reports  can  be  examined  via  the  IBMS  Tools.  See  Chapter  7. 

7  *.prn  files  can  be  imported  into  any  Lotus  123  compatible  spreadsheet  program. 
*.log  files  provide  a  record  of  program  execution. 
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1 

#run  f i le 

2 

# 

3 

# 

4 

# 

5 

# 

6 

y 

7 

y 

8 

y 

9 

y 

10 

n 

11 

c 

12 

n 

13 

14 

15 

16 

1 

17 

y 

18 

n 

19 

n 

20 

21 

u 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

c 

37 

38 

bridge.dat 

39 

default 

40 

except . exp 

41 

except 2. exp 

42 

c 

43 

44 

dtree 

45 

d  tree. par 

46 

c 

47 

48 

dtree. out 

49 

cost 

50 

life. par 

51 

cost. par 

52 

c 

53 

54 

cost. out 

55 

rank 

56 

weight. par 

57 

utility. par 

58 

c 

59 

60 

rank. out 

61 

opt 

62 

opt. par 

63 

c 

64 

65 

dollar. par 

66 

default 

Style  (n)orm  pres(w)orth  (l)ookahead  (p)wlookahead 
Do  maintenance  cost  calculations?  (y/n) 
Lengthen  Bridges  with  exceptions  and  replace?  (y/n) 
Widen  Bridges  with  exceptions  and  rehab?  (y/n) 


All:  Print  text  reports?  (y/n) 

All:  Print  123  reports?  (y/n) 

All:  Print  log  file?  (y/n) 

All:  Check  bridge  records?  (y/n) 

All:  Process  exceptions?  (y/n) 

Dtree:  Report  Style  (n)ormal  (c)ondition  (e)xception 

Dtree:  Use  second  exception  file?  (y/n) 

Dtree: 

Dtree: 

Dtree 

Cost: 

Cost: 

Cost: 

Cost: 

Cost: 

Rank:  Report  style  (n)ormal  (u)tility 

Rank: 

Rank: 

Rank: 

Rank: 

Opt: 

Opt: 

Opt: 

Opt: 

Opt: 

reserved 

reserved 

reserved 

reserved 

reserved 

Bridge  database  files 

Bridge  data  file  from  \bridge\bridge 
Bridge  index  file  from  \bridge\bridge 
Primary  exception  file 
Secondary  exception  file 

Decision  tree  program  files 

File  prefix  for  .out  .txt  .prn  .log  output  files 
Parameter  file:  defines  decision  criteria  (must  have 

Economic  analysis  program  files 
Input  file  for  cost  analysis 

File  prefix  for  .out  .txt  .prn  .log  output  files 
Life  cycle  model  parameters  (must  have  .par) 
Cost  estimate  coefficient  parameter  file 

Ranking  program  files 
Input  file  for  ranking 

File  prefix  for  .out  .txt  .prn  .log  output  files 
Ranking  weights  (must  have  .par) 
Disutility  function  parameters  (must  have  .par) 

Optimization  program  files 
Input  file  for  optimization 
File  prefix  for  .txt  .prn  .log  output  files 
Optimization  parameters  (must  have  .par) 


.par) 


Other  files 

Interest  rate  and  $  conversion  factors  (must  have 
Log  File  (overrides  log  file  name  from  above) 


par) 


Note:  Line  numbers  are  provided  for  reference  only;  they  do  not  appear  in  the  actual  file. 


Figure  4.1  Runfile  Listing 


Table  4.2  Description  of  Runfile 


37 


Line 
Number 

Entry 

Description1 

1 

#run_file 

o  File  type  identifier, 
o  This  line  cannot  be 
changed;  otherwise,  the 
program  will  not  run. 

6 

y  or  n 

o  if  "y",  text  reports  are 

printed  for  each  program. 

o  Applicable  to  all  programs. 

7 

y  or  n 

o  if  "y" ,  a  file  is  created, 

which  can  be  read  by  Lotus 

12  3  or  a  compatible 

spreadsheet  program. 

o  Use  the  import  command  to 

load  the  file. 

o  Applicable  to  all  programs. 

8 

y  or  n 

o  if  "y",  a  record  of  each 

program  run  is  printed. 

o  Useful  for  pinpointing  any 

errors  that  may  occur  during 

program  execution. 

o  Applicable  to  all  programs. 

9 

y  or  n 

o  if  "yM,  records  read  from 
the  bridge  database  are 
checked  for  errors. 
o  if  bad  bridge  records  are 
processed  (set  to  "n") , 
program  operation  will  be 
unpredictable . 

o  All  errors,  fatal  and  non- 
fatal, are  flagged  and  listed 
in  DTREE's  logfile.2 
o  Prbridge.exe  may  also  be 
used  to  check  bridge  database 
files.3 
o  Applicable  to  all  programs. 

10 

y  or  n 

o  if  "y",  system  will  attempt 
to  find  exception  records  for 
each  bridge. 

o  if  "n" ,  system  will  not 
process  any  exception 
records,  including  those  from 
the  secondary  exception  file.4 
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Table  4.2,  continued 


Line 
Number 

Entry 

Description1 

11 

n,  c,  or  e 

o  Report  styles:  (n)ormal, 

(e)xception,  and  (c)ondition 

numbers.5 

o  Applicable  only  to  DTREE. 

12 

y  or  n 

o  if  "y" ,  system  will  attempt 
to  open  and  use  a  secondary 
exception  file.4 
o  Applicable  only  to  DTREE. 

13  -  15 

- 

o  Reserved  for  future  use. 
o  Applicable  only  to  DTREE. 

16 

n,  1,  p,  or  w 

o  Report  styles:  (n)ormal; 
(l)ook  ahead;  normal,  present 
(w)orth;  and  look  ahead, 
(p) resent  worth.5,6 
o  Applicable  only  to  COST. 

17 

y  or  n 

o  if  "y",  maintenance  costs 

are  computed  in  the  life 

cycle  analysis. 

o  To  disable,  set  option  to 

"n" . 

o  Applicable  only  to  COST. 

18 

y  or  n 

0  If  "y",  bridges  will  be 

lengthened  when  an  exception 

is  specified  or  a  replacement 

is  recommended. 

o  if  "n",  all  bridge  lengths 

remain  unchanged.4 

O  Applicable  only  to  COST. 

19 

y  or  n 

o  if  "y",  bridges  will  be 

widened  when  an  exception  is 

specified  or  a  widening 

option  is  recommended. 

o  if  »n",  all  bridge  widths 

remain  unchanged.4 

O  Applicable  only  to  COST. 

20 

- 

o  Reserved  for  future  use. 
o  Applicable  only  to  COST. 

21 

n  or  u 

o  Report  styles:  (n)ormal  and 

dis(u)tility  values.5 

o  Applicable  only  to  RANK. 
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Table  4.2,  continued 


Line 
Number 

Entry 

Description1 

22  -  25 

- 

o  Reserved  for  future  use. 
O  Applicable  only  to  RANK. 

26  -  30 

- 

o  Reserved  for  future  use. 
o  Applicable  only  to  OPT. 

31  -  35 

- 

o  Reserved  for  future  use. 

38  -  41 

files 

o  Bridge  database  files. 

44  -  45 

files 

o  Decision  tree  program 
files. 

48  -  51 

files 

o  Economic  analysis  program 
files. 

54  -  57 

files 

o  Ranking  program  files. 

60  -  62 

files 

o  Optimization  program  files. 

65  -  66 

files 

o  Miscellaneous  files. 

Note:  all  option  settings  must  be  typed  in  lowercase  letters; 
file  names  may  be  typed  in  upper  or  lowercase. 

When  making  modifications,  avoid  using  tabs  and  do  not  add  or 
remove  text  lines;  otherwise,  program  results  may  be 
unreliable. 


1  Refer  to  Table  4.1  for  more  information. 

2  Fatal  errors  occur  when  a  bridge  record  contains  bad  or 
missing  data,  such  as  condition  numbers,  needed  for  program 
calculations.  Any  record  with  one  or  more  fatal  errors  will 
be  rejected  and  an  error  message  will  be  printed.  Nonfatal 
errors  occur  when  data  does  not  conform  to  the  NBIS,  but  does 
not  affect  program  operation. 

3  See  Chapter  7,  Section  2.1. 

4  See  Chapter  6. 

5  See  Appendix  G  for  examples. 

6  The  first  two  reports  styles  convert  costs  from  the  base 
year  to  the  year  of  analysis;  the  last  two  calculate  present 
worth  costs.  See  Chapter  5,  Section  7  and  econ.for  for  more 
information. 
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CHAPTER  5  PARAMETER  FILES 

Parameter  files  are  the  primary  link  between  the  IBMS  and 
the  user.  These  files  allow  the  user  to  easily  modify 
equation  constants,  coefficients,  conversion  factors,  and 
other  information,  without  having  to  search  through  the  source 
code. 

All  parameter  files  are  text  files  that  contain  both  data 
and  comments,  and  are  read  with  standard  FORTRAN  or  C 
statements  found  in  the  source  code.  These  files  may  be 
edited  with  any  text  editor,  such  as  the  OS/2  System  Editor, 
or  word  processing  program.  Unlike  the  source  code, 
parameter  files  do  not  need  to  be  re-compiled  when 
modifications  are  made. 


5.1  Parameter  File  Format 
Certain  features  are  common  to  all  parameter  files  in  the 
IBMS:  parameter  file  type,  comment  area,  data  lines,  and 
comment  lines. 
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5.1.1  Parameter  File  Type 
The  first  line  of  the  file  is  a  continuous  string  of 
characters,  no  more  than  80  characters  long,  which  identifies 
the  file  type.  Programs  using  parameter  files  will  check  this 
string  to  ensure  that  the  parameter  file  is  of  the  proper 
type;  if  not,  an  error  will  be  flagged.  An  example  of  a  file 
type  is  written  as  follows:  #ranking_weight_parameter_f ile. 
These  file  type  identifiers  must  be  identical  to  those 
expected  by  the  IBMS,  or  programs  that  use  parameter  files 
will  be  unable  to  load  them.  Therefore,  the  user  should  avoid 
changing  the  first  line  of  the  file  when  editing  the  parameter 
file. 


5.1.2  Comment  Area 
The  next  4  lines  of  the  parameter  file  contain 
information,  such  as  instructions  and  comments,  that  may  be 
helpful  to  the  user.  Each  line  must  have  at  least  one 
character  or  space  in  the  first  position,  and  no  more  than  8  0 
characters  per  line.  For  example,  a  typical  comment  area  may 
include  the  following  information: 

#  This  file  contains  weights  for  use  in  the  ranking  process. 

#  Each  weight  must  be  a  non-negative  number. 

#  Weights  will  be  normalized  to  sum  to  1  when  the  program  is  run. 

#  Be  careful  not  to  delete  or  add  lines  when  editing  this  file. 

The  remainder  of  the  parameter  file  consists  of  data  and/or 
comment  lines.  No  lines  may  be  added  or  deleted  from  the 
file,  or  else  programs  which  use  these  parameter  files  will 
either  not  run  or  produce  unreliable  results. 
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5.1.3  Data  Lines 

A  data  line  includes  two  fields:  data  and  comment.  The 
data  field  contains  information  processed  by  the  programs  and 
is  found  in  positions  1  through  20.  The  comment  field 
consists  of  the  remaining  60  characters. 

To  avoid  program  termination,  certain  restrictions  apply. 
Programs  reading  information  from  the  data  field  may  look  at 
all  20  characters;  therefore,  it  is  important  that  the  data 
and  comment  fields  do  not  overlap.  Overlap  can  be  avoided  by 
ensuring  that  all  20  positions  in  the  data  field  are  filled 
with  either  data  or  blank  spaces.  Avoid  using  tabs  to  fill  in 
the  data  field;  while  the  file  may  look  acceptable  on  the 
screen,  a  Fortran  program  will  interpret  each  tab  as  only  one 
character  position.  Therefore,  if  tabs  are  used  in  the  data 
field,  the  program  may  read  information  from  the  comment 
field,  causing  an  error  to  occur  and  the  program  to  stop. 


5.1.4  Comment  Lines 
These  lines  act  as  spacers  in  the  parameter  file,  making 
it  more  readable  and  understandable.  As  mentioned  previously, 
no  lines  may  be  added  or  removed.  Comment  lines  must  include 
at  least  one  character  or  space,  and  no  more  than  80 
characters.  Note  that  some  listings  may  appear  to  have  blank 
lines;  in  reality,  spaces  have  been  inserted.    To  avoid 
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program  errors,  add  at  least  one  character.   Examples  include 
the  following: 

1   5   10   15   20   25   30   35   40   45   50   55   60   65   70   75   80 
+ + + + + + + + + + + + + + + + 

]  Enter  Bridge  database  file  below 
c 
c 

Section  2  of  Parameter  File — 

c 


5.2  Decision  Tree  Parameter  File 

This  parameter  file  defines  the  criteria  for  each  branch 
of  the  decision  tree.  The  decision  tree  consists  of  a  series 
of  nodes,  where  a  decision  is  made  at  each  one;  based  on  that 
decision,  the  tree  proceeds  to  another  node.  After  a  series 
of  decisions  are  made,  the  tree  recommends  a  project  or  action 
for  the  bridge.  Note  that  this  parameter  file  is  used  only  by 
DTREE . 

A  decision  tree  for  major  highway  bridges  was  illustrated 
in  Figure  2.2.  Each  diamond  on  the  diagram  symbolizes  a  node 
of  the  decision  tree;  up  to  16  nodes  can  be  defined.  Each 
node  represents  a  property  of  the  bridge  that  is  used  to  make 
a  decision;  for  example,  node  3  (DG)  stands  for  the  deck 
geometry  code,  Item  68  in  the  Recording  and  Coding  Guide.  In 
addition,  each  node  has  two  numbers  associated  with  it:  a 
"high  value"  and  a  "low  value."  The  former  value  is 
represented  by  a  greater  than  or  equal  to  sign  (  >=  )  and  the 
latter  by  a  less  than  or  equal  to  sign 
(  <=  )• 

Note  that  the  structure  of  the  tree  is  fixed;  nodes  that 
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have  two  possible  branches  may  never  be  converted  to  nodes 
with  three  branches.  However,  by  setting  the  high  and  low 
values  properly,  a  node  with  three  branches  may  be  manipulated 
to  behave  as  if  it  had  only  two  branches.  To  avoid  errors  in 
the  decision  process,  a  node  with  only  two  branches  must  have 
high  and  low  values  that  are  consecutive  integers;  nodes  with 
three  branches  do  not  require  consecutive  integers.  Examples 
for  a  major  highway  are  given  in  the  following  section. 


5.2.1  Case  1:  Node  3  -  DG  (Deck  Geometry) 

The  high  and  low  values  for  this  node  are  set  at  6  and  5, 

respectively.   If  this  node  is  encountered  in  the  decision 

making  process  for  a  bridge,  then  its  deck  geometry  code  is 

inspected  in  the  bridge  database  record.  If  the  deck  geometry 

code  is: 

>=  6 ,  the  branch  proceeds  to  node  4 ,  VC 
<=  5,  the  branch  proceeds  to  node  14,  SUP 

If  the  high  and  low  values  were  specified  as  6  and  4, 
respectively,  an  error  would  occur  if  the  bridge's  deck 
geometry  code  was  5,  since  5  is  neither  less  than  or  equal  to 
4  or  greater  than  or  equal  to  6.  Consequently,  a  node  with 
only  two  branches  must  have  consecutive  integers  for  its  high 
and  low  values  to  avoid  errors  in  the  decision  process. 
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5.2.2  Case  2:  Node  9  -  SUP  (Superstructure  Condition) 

The  high  and  low  values  for  this  node  are  specified  as  6 

and  3,  respectively.   If  the  decision  making  process  for  a 

bridge  reaches  this  node,  its  superstructure  condition  number 

is  inspected.   If  this  number  is: 

>=  6,  the  tree  proceeds  to  node  10,  DC 

<=  3 ,  an  action  of  9  is  recommended 

=  4  or  5,  the  tree  branches  to  node  11,  DC 

Since  these  values  are  not  consecutive  integers,  a  node  with 
three  branches  exists.  It  is  possible  to  limit  the  node  to 
only  two  branches;  however,  the  elimination  of  a  branch  may 
produce  unpredictable  results.  For  example,  if  the  high  and 
low  values  are  set  to  4  and  5,  respectively,  it  is  impossible 
for  the  decision  tree  to  reach  node  11. 


5.2.3  Defining  a  Decision  Tree 
As  illustrated  in  the  examples  above,  each  node  is 
assigned  two  numbers  that  dictate  the  decision  process  at  that 
point.  A  set  of  16  pairs  of  high  and  low  values  describes  a 
decision  tree;  up  to  four  sets  of  decision  trees  may  be 
defined  in  the  IBMS.  Each  set  applies  to  all  bridges  with  a 
given  mapped  functional  class  code.  This  code  is  a  number 
from  1  to  4,  which  is  derived  from  the  functional  class  code 
of  a  bridge,  as  defined  in  Item  5  of  the  Recording  and  Coding 
Guide.  When  a  bridge  record  is  read,  its  functional  class 
code  is  converted  from  the  Recording  and  Coding  Guide  standard 
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to  one  of  these  four  mapped  codes.  At  present,  only  two 
mapped  functional  class  codes  are  defined,  1  and  2,  which 
correspond  to  major  and  minor  highway  bridges,  respectively. 
For  more  information,  see  Chapter  2,  Section  6  and  Table  2.1. 

Each  set  of  decision  tree  criteria  is  defined  in  the 
parameter  file  as  a  block  of  16  pairs  of  high  and  low  values. 
Additional  blocks  may  be  added  to  the  end  of  the  file; 
however,  all  16  pairs  of  numbers  and  all  comment  lines  must  be 
included  for  proper  program  execution.  To  add  additional 
blocks,  the  programs  MAP. FOR  and  BDATA.FOR  must  be  modified 
and  all  system  programs  must  be  re-compiled  to  incorporate 
this  additional  information.  For  information  on  compiling  the 
programs,  refer  to  Appendix  I. 

Decision  tree  criteria  sets  are  presently  defined  for 
major  and  minor  highway  bridges.  High  and  low  values  for 
these  sets  may  be  changed  by  editing  the  default  decision  tree 
parameter  file  and  specifying  a  new  name,  such  as  dtree2.par, 
in  the  runfile.  When  making  modifications  to  these  two  sets, 
the  program  does  not  have  to  be  re-compiled. 


5.2.4  Default  Decision  Tree 
A  diagram  of  the  default  decision  tree  for  mapped 
functional  class  1  (major  highway)  was  provided  in  Chapter  2; 
see  Figure  2.2.  A  program  listing  of  the  file  is  provided  in 
Figure  5.1;  Table  5.1  provides  a  general  overview  of  the 
decision  tree  parameter  file.   Note  that  the  values  defining 
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1 

#decision 

2 

# 

3 

# 

4 

# 

5 

# 

6 

X 

7 

X 

8 

X 

9 

X 

10 

c 

11 

1 

12 

c 

13 

0 

14 

0 

15 

c 

16 

16 

17 

17 

18 

c 

19 

5 

20 

6 

21 

c 

22 

15 

23 

16 

24 

c 

25 

2 

26 

5 

27 

c 

28 

3 

29 

6 

30 

c 

31 

4 

32 

6 

33 

c 

34 

4 

35 

5 

36 

c 

37 

3 

38 

6 

39 

c 

40 

4 

41 

6 

42 

c 

43 

4 

44 

6 

45 

c 

46 

3 

47 

4 

48 

c 

49 

4 

50 

6 

51 

c 

52 

3 

53 

4 

54 

c 

55 

4 

56 

6 

57 

c 

58 

0 

59 

0 

60 

c 

61 

2 

62 

c 

63 

0 

64 

0 

65 

c 

66 

16 

i_tree_parameter_f  i  le 


reserved 
reserved 
reserved 
reserved 


Major  Highway  Functional  Class  (Item  26:  1,  2,  7,  11,  12,  or  14) 


Low 
High 

Low 
High 

Low 
High 

Low 
High 

Low 
High 

Low 
High 

Low 
High 

Low 
High 

Low 
High 

Low 
High 

Low 
High 

Low 
High 

Low 
High 

Low 
High 

Low 
High 

Low 
High 

Minor  H 

Low 
High 


or  node  1  ADT 
or  node  1 

or  node  2  Inventory  Tons 
or  node  2 

or  node  3  Deck  Geometry 
or  node  3 

or  node  4  Vertical  Clearance  (ft) 
or  node  4 

or  node  5  Substructure  Condition 
or  node  5 

or  node  6  Superstructure  Condition  (a) 
or  node  6 

or  node  7  Deck  Condition  (a) 
or  node  7 

or  node  8  Deck  Condition  (b) 
or  node  8 

or  node  9  Superstructure  Condition  (b) 
or  node  9 

or  node  10  Deck  Condition  (c) 
or  node  10 

or  node  11  Deck  Condition  (d) 
or  node  11 

or  node  12  Superstructure  Condition  (c) 
or  node  12 

or  node  13  Deck  Condition  (e) 
or  node  13 

or  node  14  Superstructure  Condition  (d) 
or  node  14 

or  node  15  Deck  Condition  (e) 
or  node  15 

or  node  16  Not  Used 
or  node  16 

ghway  Functional  Class  (Item  26:  6,  8,  9,  16  or  19) 

or  node  1  ADT 
or  node  1 


]  Low  for  node  2  Inventory  Tons 


Figure  5.1  Decision  Tree  Pare^eter  File  Listing 
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67 

17 

68 

c 

69 

5 

70 

6 

71 

c 

72 

15 

73 

16 

74 

c 

75 

2 

76 

5 

77 

c 

78 

3 

79 

6 

80 

c 

81 

4 

82 

6 

83 

c 

84 

4 

85 

5 

86 

c 

87 

3 

88 

6 

89 

c 

90 

4 

91 

6 

92 

c 

93 

4 

94 

6 

95 

c 

96 

3 

97 

4 

98 

c 

99 

4 

100 

6 

101 

c 

102 

3 

103 

4 

104 

c 

105 

4 

106 

6 

107 

c 

108 

0 

109 

0 

]  High  for  node  2 


]  Low 
]  High 

for 
for 

node 
node 

3 
3 

)eck  Geometry 

]  LOW   1 

]  High  1 

for 
for 

node 
node 

4 

4 

Vertical  Clearance  (ft) 

]  Low  1 
]  High  1 

for 
for 

node 
node 

5 

5 

Substructure  Condition 

]  Low  1 
]  High  1 

for 
for 

node 
node 

6 
6 

Superstructure  Condition  (a) 

]  Low  1 
]  High  1 

or 

for 

node 
node 

7  Deck  Condition  (a) 

7 

]  Low  1 
]  High  1 

for 

for 

node 
node 

8 
8 

)eck  Condition  (b) 

]  Low  1 
]  High  1 

for 

cor 

node 
node 

9 
9 

Superstructure  Condition  (b) 

]  Low  1 
]  High  1 

for 
or 

node 
node 

10 
10 

Deck  Condition  (c) 

]  Low  1 
]  High  1 

for 
'or 

node 
node 

11 
11 

Deck  Condition  (d) 

]  Low  1 
]  High  1 

:or 
:or 

node 
node 

12 
12 

Superstructure  Condition  (c) 

]  Low  1 
]  High  1 

or 
or 

node 
node 

13 
13 

Deck  Condition  (e) 

]  Low  1 
]  High  1 

or 
or 

node 
node 

14 
14 

Superstructure  Condition  (d) 

]  Low 
]  High  1 

or 
or 

node 
node 

15 
15 

Deck  Condition  (e) 

]  Low  1 
]  High  1 

or 
or 

node 
node 

16 
16 

Not  Used 

Mote:  Line  numbers  are  provided  for  reference  only;  they  do  not  appear  in  the  actual  parameter  file. 

When  making  modifications,  avoid  using  tabs  and  do  not  add  or  remove  text  lines;  otherwise,  program 
results  may  be  unreliable. 


Figure  5.1,  continued 
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Table  5.1  Decision  Tree  Parameter  File  Field  Descriptions 


Line 

Nunber 

Entry 

Description 

1 

£deci  si  on_tree_parameter_f  i le 

o  Parameter  file  type  identifier. 

o  This  line  cannot  be  changed;  otherwise,  the 

program  will  not  run. 

2  -  10 

Comments 

o  Do  not  remove  any  comment  lines  from  the  file; 
these  lines  may  contain  instructions  or 
information  for  the  user. 

11 

1 

o  Mapped  functional  class  code  for  the  decision 

criteria  set. 

o  Used  internally  to  locate  and  choose  the 

correct  decision  tree  for  a  bridge. 

o  Do  not  change  this  field. 

13  -  14 

Nunber 

Sjrcer 

o  High  and  low  values  for  node  1  of  the  decision 
tree. 

16  -  17 

Number 

Nunber 

o  High  and  low  values  for  node  2. 

58  -  59 

0 
0 

o  High  and  low  values  for  node  16. 
o  Note  that  this  node  does  not  exist  in  the 
default  decision  tree  (values  are  therefore  set 
to  0);  these  values  are  included  for  future 
expans  i  on . 

61 

2 

o  Happed  functional  class  code  for  the  second 

set  of  decision  criteria. 

o  Used  internally  to  locate  and  choose  the 

correct  decision  tree  for  a  bridge. 

o  Do  not  change  this  field. 

62  + 

Nunber 

Nunber 

o  These  lines  describe  the  second  set  of  the 
decision  tree  criteria. 

When  making  modifications,  avoid  using  tabs  and  do  not  add  or  remove  text  lines;  otherwise,  program 
results  may  be  unreliable. 
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the  decision  tree  criteria  are  the  same  for  both  major  and 
minor  highways;  the  user  can  modify  these  values  as  needed. 
If  modifications  are  made  to  the  parameter  file,  extra 
comment  lines  may  not  be  added  to  the  end  of  the  file 
because  the  subroutine  (GETDECIS.FOR)  that  reads  the 
decision  tree  information  may  mistake  them  for  a  third  set 
of  numbers  and  cause  unpredictable  results.   If  errors  occur 
when  reading  this  file,  check  the  format  of  the  parameter 
file;  the  listing  provided  in  Figure  5.1  can  be  used  for 
comparison. 

5.3  Cost  Parameter  File 
The  cost  estimate  parameter  file  contains  the 
information  needed  to  compute  replacement  and  rehabilitation 
costs  for  bridge  projects.   While  the  functional  forms  of 
the  equations  used  to  compute  these  costs  are  fixed,  the 
constants,  coefficients,  and  powers  of  the  equations  may  be 
modified  within  the  parameter  file.   A  program  listing  of 
the  file  is  shown  in  Figure  5.2;  Table  5.2  provides  an 
overview  of  the  parameter  file.   Note  that  this  parameter 
file  is  used  only  in  the  COST  program.   Derivations  for  cost 
equations  can  be  found  in  the  report,  FHWA/IN/JHRP- 89/11, 
"The  Development  of  Optimal  Strategies  for  Maintenance, 
Rehabilitation  and  Replacement  of  Highway  Bridges,  Final 
Report  Vol.  4:  Cost  Analysis"  (Saito  and  Sinha  1989). 


51 


Patching  Costs  (da  =  deck 

area, 

pa  =  patch  X) 

]  cl  patch  X   cut-off 

]  c2  deck  area  break  1 

]  c3  deck  area  break  2 

]  d1  unit  cost  1  (S/ft2) 

if  pa 

<  d  and  da  <  c2 

]  d2  unit  cost  1  (S/ft2) 

if  pa 

<  d  and  c2  <=  da  <c3 

1  d3  unit  cost  1  (S/ft2) 

if  pa 

<  cl  and  da  >=  c3 

]  d4  unit  cost  1  (S/ft2) 

if  pa 

>=  d  and  da  <  c2 

]  d5  unit  cost  1  ($/ft2) 

if  pa 

>=  d  and  c2  <=  da  <c3 

]  d6  unit  cost  1  (S/ft2) 

if  pa 

>=  d  and  da  >=  c3 

1  stecst  oarameter  file 

2  I 

3  * 

4  # 

5  * 

6  c  Rehabilitation  (volume  *  section  2.3) 

7  c  

S  c 

9  c  Option  1)  Deck  Replace 

10  c 

11  c  cost  =  width  *  length  *  a1  *  (1+a2)/1000 

12  31.1SS  ]  a1 

13  0.S103  ]  a2 
U  c 

15  c  Option  2)  Deck  Reconstruction  and  Overlay 

16  c 

17  7.0  ]  b1  X   of  surface  patched  for  a  major  highway 

18  12.0  ]  b2  X   of  surface  patched  for  a  minor  highway 

19  c 

20  c 

21  15.0 

22  500.0 

23  2000.0 

24  13.74 

25  9.09 

26  5.73 

27  16.09 

28  10.11 

29  8.11 

30  c 

31  c  Deck  Reconstruction  Cost  rb=unitcost1*area/1000 

32  100.0  ]  e1  recon  cost  break  point 

33  1.2331  ]  f1  unit  cost  2  if  (rb  <  e1) 

34  0.9311  ]  f2  unit  cost  2  if  (rb  >=  e1) 

35  c  Total  rehab  cost  =  rb*(1  ♦  unitcost2) 

36  c 

37  c 

38  c  Bridge  Replacement  (volume  4  section  2.2) 

:--  :  

40  c 

41  c  Superstructure  cost 

42  c 

43  c  RC  Slab  or  Box  Beam  cost  =  g1*len"g2*wid**g3 

44  0.0137  ]  g1 

45  1.001  ]  g2 

46  1.161  ]  g3 

47  c  Concrete  I -Beam  cost  =  g4*len**g5*wid**g6 

48  0.033  ]  g4 

49  0.907  ]  g5 

50  1.043  ]  g6 

51  c  Steel  Beam  cost  =  g7*len"g8*wid**g9 

52  0.0102  ]  g7 

53  1.12  ]  g8 

54  1.117  ]  g9 

55  c  Steel  Girder  cost  =  g10*len**g11*wid**g12 

56  0.0885  ]  g10 

57  0.906  ]  g11 

58  0.747  ]  g12 

59  c 

60  c  Substructure  Cost 

61  c 

62  c  Solid  Stem  cost  =  h1*len"h2  *  wid**h3  *  vclear**h4 

63  0.00506  ]  hi 

64  0.744  ]  h2 

65  1.205  ]  h3 

66  0.515  )  h4 


Figure  5.2  Cost  Estimate  Parameter  File  Listing 
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67  c  Pile  Type  cost  =  h5*len"h6  •  Mi'eJ**h7  *  vclear"h8 

68  0.00354  ]   h5 

69  0.744  ]    K6 

70  1.205  1   h7 

71  0.515  ]    ho 

72  c 

71  c  Approach   Costs   =    i1    *  approach  I  ength"i  2 

74  0.769  J    il 

75  0.823  ]    12 

76  c 

77  c  Other  Costs'   =  J1«len"j2  •  yid"j3 

78  0.0721  ]    j'1 

79  0.696  J    j2 

80  0.932  ]    j3 

81  c 

82  c  Total  Replace  Cost  =  supcost*succost»appccst»cthercosts 

83  c 

84  c 

85  c  Miscellaneous  default  costs 

86  c  

87  c 

88  25.0  ]  Oefault  cost  of  substructure  rehabilitation  (S1000's) 

89  350.0  ]  Oefault  cost  of  raising/lowering  pavement  (S1000's) 

90  200.0  ]  Default  cost  of  culvert  replacement  (S1000JS) 

Mote:  Line  nunfcers  are  provided  for  reference  only;  they  do  not  appear  in  the  actual  parameter  file. 

When  making  modifications,  avoid  using  tabs  and  do  not  add  or  remove  text  lines;  otherwise,  program 
results  nay  be  unreliable. 

1  "Other"  costs  include  structure,  mobilization/demobilization,  traffic  control,  denolition,  and 
miscellaneous  costs,  expressed  in  terms  of  deck  area  (Saito  and  Sinha  1989) 


Figure  5.2,  continued 
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Table  5.2  Cost  Parameter  File  Field  Descriptions 


Line 

Number 

Entry 

Description 

1 

#cost_parameter_f i le 

o  File  type  identifier. 

o  This  line  cannot  be  changed;  otherwise,  the  program  will 

not  run. 

2  -  11 

Comments 

o  Do  not  remove  any  comment  lines  from  the  file;  these 
lines  may  contain  instructions  or  information  for  the  user. 

12  -  13 

a1 

32 

o  Coefficients  for  deck  replacement  calculations, 
o  Real  numbers  of  up  to  20  digits  may  be  specified,  but  the 
actual  precision  is  limited  to  the  number  of  digits  in  the 
mantissa  of  a  real  number,  which  is  dictated  by  the  Fortran 
compi ler  used. 

17  -  18 

b1 
b2 

o  Specifies  the  estimated  patching  percentages  for  major 
and  minor  highway  bridges. 

21  -  29 

d...c3 
d1...d6 

o  Constants  for  calculation  of  "unit  cost  1." 
o  See  costest.for  for  more  information. 

32  -  34 

e1 
f1 
f2 

o  Constants  for  calculating  "unit  cost  2." 

44  -  46 

91...93 

o  Coefficients  for  calculation  of  bridge  replacement  costs 
for  RC  slab  or  box  beam  bridges. 

48  -  50 

g4. ..g6 

o  Bridge  replacement  cost  coefficients  for  I-beam  bridges. 

52  -  54 

97...g9 

o  Cost  coefficients  for  steel  beam  bridge  replacements. 

56  -  58 

g10...g12 

o  Coefficients  for  steel  girder  replacements. 

63  -  66 

h1...h4 

o  Substructure  cost  coefficients  for  solid  stem  bridges. 

68  -  71 

h5...h8 

o  Substructure  cost  coefficients  for  pile  type  bridges. 

78  -  80 

i"1 
i2 

o  Parameters  used  to  estimate  miscellaneous  (other)  costs. 

88 

25.0 

o  Default  cost  (in  thousands)  for  substructure 
rehabi litation. 

89 

350.0 

o  Default  cost  (in  thousands)  for  raising/lowering 
pavement . 

90 

200.0 

o  Default  cost  (in  thousands)  for  culvert  replacement, 
o  Not  used  in  current  IBMS  version. 

When  making  modifications,  avoid  using  tabs  and  do  not  add  or  remove  text  lines;  otherwise,  program 
results  may  be  unreliable. 
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5.3.1  Rehabilitation 

There  are  two  main  types  of  rehabilitation:  1)  deck 
replacement  and  2)  deck  reconstruction  and  overlay.   Costs 
for  the  first  type  (action  codes  2,  4,  7 ,  and  11)  are  a 
function  of  the  deck  area,  while  costs  for  the  second  type 
(action  codes  1,  3,  6,  8, and  10)  are  determined  by  the 
patching  percentage  of  the  bridge  deck  area. 

Other  costs,  such  as  superstructure  or  substructure 
repairs,  may  be  derived  from  these  two  main  rehabilitation 
types.   For  example,  an  action  code  of  3  specifies  a 
superstructure  rehabilitation  and  deck  rehabilitation.   To 
find  the  cost  of  this  project,  the  cost  of  deck 
rehabilitation  is  first  calculated  from  the  eguation 
specified  in  the  parameter  file;  next,  an  additional  5%  is 
added  to  include  the  superstructure  cost.   All  other  subtype 
costs  are  computed  in  a  similar  fashion;  refer  to  Appendix  H 
for  further  information. 


5.3.2  Bridge  Replacement 
The  cost  of  a  bridge  replacement  project  (action  codes 
9,  12,  13,  14,  and  16)  is  a  function  of  the  bridge's  deck 
area,  superstructure  and  substructure  types,  and  approach 
length . 
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5.3.3  Miscellaneous  Default  Costs 
Some  repair  codes  (5,  15,  and  17)  depend  on  neither 
replacement  nor  rehabilitation  costs;  these  costs  are 
assigned  default  values  in  the  programs.   Note  that  at  the 
present  time,  DTREE  will  never  produce  a  recommendation  for 
repair  code  17;  however,  a  default  cost  is  provided  for 
future  expansion.   Refer  to  Appendix  H  for  more  details. 

5.4  Life  Cycle  Model  Parameter  File 
To  determine  equivalent  uniform  annual  cost  (EUAC) 
calculations  for  bridge  projects,  a  life  cycle  model  must  be 
defined,  which  allows  the  system  to  predict  future  repair 
activities.   Different  models  exist  for  each  type  of  bridge, 
such  as  steel  or  concrete.   These  models  will  specify  the 
necessary  repairs  to  perform,  as  well  as  when  these  repairs 
probably  will  occur.   In  addition,  a  method  for  estimating 
maintenance  costs  for  the  time  interval  between  repairs  must 
be  defined  for  each  bridge  type. 

The  life  cycle  parameter  file  allows  the  user  to  define 
life  cycle  models  for  different  superstructure  types.   The 
current  IBMS  defines  only  two  types:  steel  (code  1)  and 
concrete  (code  2) ,  which  are  the  first  and  second  models  in 
the  parameter  file,  respectively.   When  superstructure  types 
are  added,  the  third  life  cycle  model  should  correspond  to 
superstructure  type  3 ,  the  fourth  model  to  type  4 ,  and  so 
on.   Note  that  when  adding  a  type  to  the  parameter  file,  the 
programs  BDATA.FOR  and  MAP. FOR  must  be  modified  and  the  COST 
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program  re-compiled. 

A  listing  of  the  file  is  included  in  Figure  5.3;  Table 
5.3  provides  an  overview  of  the  life  cycle  parameter  file. 
Note  that  this  parameter  file  is  used  only  in  the  COST 
program. 


5.4.1  Developing  the  Life  Cycle  Models 
Certain  information  is  required  to  develop  the  models: 
1)  bridge  types,  2)  life  span,  3)  rehabilitation  types  and 
times,  and  4)  maintenance  costs. 


5.4.1.1  Bridge  Types 

The  bridge  superstructure  type  determines  which  cost 
model  is  used.   As  mentioned  above,  only  two  superstructure 
types  are  defined  for  the  IBMS:  steel  and  concrete.   Repair 
types  and  times  also  depend  on  the  superstructure  type. 
While  repair  costs  also  depend  on  other  bridge  properties, 
the  superstructure  type  alone  determines  when  these  repairs 
are  done. 


5.4.1.2  Life  Span 

The  average  expected  life  span  for  each  bridge  type 
must  be  determined.  See  Table  5.4  for  INDOT's  estimated 
bridge  design  life. 
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1 
2 
3 
4 
5 
6 
7 
8 
9 
10 

11  1 

12  65 

13  20 

14  35 

15  50 

16  0 


25 
26 


51 
52 


55 
56 
57 
58 
59 
60 
61 


#life_cycle 

#Oescribes 

# 

# 

# 


17  3 

18  2 

19  3 

20  0 

21  . 

22  0.8504 

23  945.72 

24  3.0 
5 
1.241 

27  878.59 

28  3.0 
5 
r 


29 
30 

31  r 

32  r 

33  r 

34  r 

35  . 

36  . 

37  2 

38  50 

39  20 

40  35 

41  0 


42 
43 
44 
45 
46 

47  . 

48  0.8504 

49  945.72 

50  3.0 
5 
1.241 

53  878.59 

54  3.0 
5 
r 


_model_parameter_f i le 

life  cycle  model  for  each  bridge  type. 


reserved 

reserved 

reserved 

reserved 
Steel  Superstructure  (item  43a  code=  3,4,  or  9) 

bridge  type  code 

life  span  of  bridge  (integer  years) 

time  after  construction  for  rehabl  (years) 

time  for  rehab2  (set  to  0  if  no  second  rehab) 

time  for  rehab3  (0  if  no  third  rehab) 

time  for  rehab4  (0  if  not  needed) 

type  code  for  rehab  1 

type  code  for  rehab  2  (ignore  if  no  second  rehab) 

type  code  for  rehab  3  (ignore  if  no  third  rehab) 

type  code  for  rehab  4  (ignore  if  no  fourth  rehab) 
Maim  fields  are  ignored  if  maint  cost  calcs  are  disabled 

slope  for  major  hwy  maint  estimates 

constant  for  major  hwy  maint  estimates 

X   increase  of  replace  costs  at  end  of  life  span  for  major  huys 

yrs  after  repair  when  X   increase  begins  for  major  hwys 

slope  for  minor  hwy  maint  estimates 

constant  for  minor  hwy  maint  estimates 

%  increase  of  replace  costs  at  end  of  life  span  for  minor  hwys 

yrs  after  repair  when  X  increase  begins  for  minor  hwys 

reserved  for  future  use 

reserved  for  future  use 

reserved  for  future  use 

reserved  for  future  use 

reserved  for  future  use 

Concrete  Superstructure  (item  43a  code  =  1,2,5,6,7,8,  or  0) 

bridge  type  code 

life  span  of  bridge  (integer  years) 

time  after  construction  for  rehabl  (years) 

time  for  rehab2  (set  to  0  if  no  second  rehab) 

time  for  rehab3  (0  if  no  third  rehab) 

time  for  rehab4  (0  if  not  needed) 

type  code  for  rehab  1 

type  code  for  rehab  2  (ignore  if  no  second  rehab) 

type  code  for  rehab  3  (ignore  if  no  third  rehab) 

type  code  for  rehab  4  (ignore  if  no  fourth  rehab) 
Maint  fields  are  ignored  if  maint  cost  calcs  are  disabled 

slope  for  major  hwy  maint  estimates 

constant  for  major  hwy  maint  estimates 

X   increase  of  replace  costs  at  end  of  life  span  for  major  hwys 

yrs  after  repair  that  X   increase  begins  for  major  hwys 

slope  for  minor  hwy  maint  estimates 

constant  for  minor  hwy  maint  estimates 

X   increase  in  replace  costs  at  end  of  life  span  for  minor  hwys 

yrs  after  repair  that  X   increase  begins  for  minor  hwys 

reserved  for  future  use 

reserved  for  future  use 

reserved  for  future  use 

reserved  for  future  use 

reserved  for  future  use 


Note:  Line  numbers  are  provided  for  reference  only;  they  do  not  appear  in  the  actual  parameter 
file. 

When  making  modifications,  avoid  using  tabs  and  do  not  add  or  remove  text  lines;  otherwise,  program 
results  may  be  unreliable. 


Figure  5.3  Life  Cycle  Model  Parameter  File  Listing 
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Table  5.3  INDOT's  Estimated  Bridge  Design  Life 


Steel  Bridges 

0    year 

New 

20    years 

Deck  Rehabilitation 

35    years 

Deck  Replacement 

50   years 

Deck  Rehabilitation 

65   years 

Bridge  Replacement 

Concrete  Bridges 

0    year 

New 

20   years 

Deck  Rehabilitation 

35   years 

Deck  Rehabilitation 

50   years 

Bridge  Replacement 
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Table  5.4  Life  Cycle  Model  Field  Descriptions 


Line 

Number 

Entry 

Description 

1 

#life_cycle_model_parameter_f ile 

o  File  type  identifier. 

o  This  line  cannot  be  changed;  otherwise, 

the  program  will  not  run. 

2  -  10 

Comments 

o  Do  not  remove  any  comment  lines  from  the 
file;  these  lines  may  contain  instructions 
or  information  for  the  user. 

11 

1 

o  Superstructure  type  1  for  life  cycle  model 
1;  used  for  internal  reference  only.1 

12 

Number 

o  Life  span,  in  years,  of  bridge  type  1. 

13  -  16 

Number 

Number 
Number 
Number 

o  Time  interval,  in  years,  between 
construction  of  bridge  and  rehabilitations  1 
through  4. 

o  A  value  of  0  indicates  that  a 
rehabilitation  does  not  exist. 

17  -  20 

Number 
Number 
Number 
Number 

o  Internal  codes  for  rehabilitations  1 

through  4. 

o  Refer  to  Appendix  H  for  definition  of 

codes. 

22  -  23 

m 

b 

o  Coefficients  used  to  calculate  base 
maintenance  cost  for  a  major  highway  bridge. 

24 

P 

o  Percentage  increase  of  the  replacement 
costs  at  the  end  of  the  life  span  for  a 
major  highway  bridge. 

25 

c 

o  Number  of  years  after  a  repair  when 
maintenance  costs  start  to  increase  by  p  for 
a  major  highway  bridge. 

26  -  27 

m 

b 

o  Coefficients  for  a  minor  highway  bridge. 

28 

P 

o  Percentage  increase  of  the  replacement 
costs  at  the  end  of  the  life  span  for  a 
minor  highway  bridge. 

29 

c 

o  Number  of  years  after  a  repair  when  costs 
begin  to  increase  for  a  minor  highway 
bridge. 

30  -  36 

Comments 

o  Do  not  remove. 

37  -  61 

see  lines  11-29 

o  Definitions  for  superstructure  type  2. 

When  making  modifications,  avoid  using  tabs  and  do  not  add  or  remove  text  lines;  otherwise,  program 
results  may  be  unreliable. 

Note  that  the  equation  constants  are  based  on  previous  bridge  records  and  INDOT  staff  assessments. 

Refer  to  Chapter  2,  Section  6  for  conversion  of  superstructure  type  codes  from  the  Recording  and 
Coding  guide. 
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5.4.1.3  Rehabilitation  Types  and  Times 

For  each  bridge  type,  the  activity  profile  or  time 
interval  between  repairs  must  be  determined.   Furthermore, 
the  type  of  rehabilitation  (deck  reconstruction,  bridge 
widening,  etc.)  must  be  known.   Note  that  the  decision  tree 
schedules  immediate  repairs  (within  six  years  of  the 
analysis  year) ,  while  the  life  cycle  model  predicts  future 
repair  types  and  times.   See  Table  5.3  for  INDOT's  estimated 
activity  profile. 

5.4.1.4  Maintenance  Costs 

A  formula  for  calculating  maintenance  costs  for  each 
bridge  type  is  required.   After  any  repair,  the  maintenance 
costs  remain  constant  for  a  period  of  time;  eventually,  the 
costs  may  increase  linearly  each  year  to  a  certain 
percentage  of  the  rehabilitation  costs  at  the  end  of  the 
bridge's  life  span  (FHWA  1987) .   For  each  superstructure 
type,  separate  cost  formulas  are  defined  for  major  highways 
and  minor  highways;  refer  to  Chapter  2,  Section  6  and  Table 
2.1  for  more  information  regarding  highway  types.   A  typical 
cost  model  is  shown  in  Figure  5.4.   The  base  (or  constant) 
maintenance  cost  is  a  linear  function  of  the  deck  area  and 
is  defined  as  follows: 

costn  =(m*l*dw+b) /1000  (1) 

where : 

costn  =  thousands  of  dollars  for  year  n; 

0-c  =  time  interval  where  maintenance  costs  are 

constant; 
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m  =  slope; 

1  =  bridge  length  in  feet; 
dw  =  deck  width  in  feet; 
b  =  constant. 

Similarly,  the  equation  representing  the  yearly  increasing 
costs  is  written: 

costn    =-£-*(.n-c)  +cost0  (2) 

where : 

costn  =  thousands  of  dollars  for  year  n; 

c-d  =  time  interval  where  maintenance  costs  are 

increasing; 

p  =  percentage  increase  of  the  replacement  costs  at  the 

end  of  the  bridge's  life  span; 

cost0  =  cost  at  year  0. 

Note  that  these  equation  constants  are  based  on  previous 

bridge  records  and  INDOT  staff  assessments. 


5.5  Ranking  Weight  Parameter  File 


5.5.1  Introduction 
Each  bridge  project  is  assigned  a  disutility  or  weight 
to  determine  the  priority  of  each  project.   This  disutility 
is  found  by  calculating  a  series  of  disutility  function 
values  that  rate  the  project  based  on  its  cost 
effectiveness,  community  impact,  traffic  safety,  and  bridge 
condition.   All  function  values  range  from  0  to  100;  as  the 
disutility  increases,  the  urgency  for  repair  increases.   A 
weighted  sum  of  the  disutilities  forms  the  total  disutility 
of  the  project.   Note  that  this  parameter  file  is  only  used 
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by  the  RANK  program. 


5.5.2  Specification  of  Weights 

The  parameter  file  is  divided  into  three  groups  of 
weights:  objective  factors,  bridge  condition,  and  traffic 
safety.   The  first  group  computes  the  weighted  sum 
(disutility)  for  the  four  criteria  mentioned  in  the 
preceding  paragraph.   The  second  group  combines  the 
disutility  function  values  calculated  for  remaining  service 
life  and  structural  condition  into  one  disutility  value,  to 
determine  the  bridge  condition.   Similarly,  the  third  group 
combines  the  disutility  function  values  computed  for  clear 
deck  width,  vertical  clearance,  and  inventory  rating  into 
one  value,  which  rates  the  traffic  safety  of  the  bridge. 

For  each  group,  a  relative  set  of  weights  is  provided. 
These  weights  can  be  assigned  any  set  of  positive  numbers; 
they  will  then  be  normalized  so  that  they  sum  to  1.0.   For 
example,  suppose  the  following  set  of  relative  weights  is 
given: 

wl  =  50,  W2  =  50,  w3  =  10,  w4  =  10 
The  sum  of  these  four  weights  is  obviously  not  1.0,  or  even 
100.0.   Therefore,  to  normalize  these  weights,  the  program 
divides  each  weight  by  the  total  sum,  which  is: 

50  +  50  +  10  +  10  =  120. 
The  corresponding  normalized  weights  are  then: 

wl  =  w2  =  0.416  and  w3  =  w4  =  0.083. 
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Normalization  is  applicable  for  negative  weights  also,  but 
should  be  avoided  to  prevent  unpredictable  results. 

Disutility  functions  and  weights  are  discussed  in 
detail  in  the  report,  FHWA/IN/JHRP-89/12 ,  "The  Development 
of  Optimal  Strategies  for  Maintenance,  Rehabilitation  and 
Replacement  of  Highway  Bridges,  Final  Report  Vol.  5: 
Priority  Ranking  Method,"  Chapter  3  (Saito  and  Sinha  1989). 
The  functional  forms  of  the  disutility  equations  are 
described  in  Section  6  of  this  chapter.   A  program  listing 
of  the  file  is  shown  in  Figure  5.5;  Table" 5. 5  provides  an 
overview  of  the  parameter  file. 
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ing_weight_parameter_f i le 

ghtTng  factors  used  In  the  ranking  process.  All  weights  will  be  normalized 

1,  so  you  may  use  any  weighting  system  that  you  wish.  For  instance  if 

50  w2=50  w3=10  w4=10,  the  weights  used  internally  by  the  program  would  be: 

0.416...  w2=0.416...  w3=0.083...  w4=0.083...  Do  not  use  negative  numbers! 

Weights  For  Objective  Factors 
]  cost  effectiveness 
]  bridge  condition 
]  traffic  safety 
]  community  impact 

Two  of  the  weights  are  broken  down  further 

Weights  For  Bridge  Condition 
]  remaining  service  life 
]  structural  condition 

Weights  For  Traffic  Safety 
]  clear  deck  width 
]  vertical  clearance 
]  inventory  rating 

Note:  Line  nunbers  are  provided  for  reference  only;  they  do  not  appear  in  the  actual  parameter 
file. 

When  making  modifications,  avoid  using  tabs  and  do  not  add  or  remove  text  tines;  otherwise,  program 
results  may  be  unreliable. 


1 

#rank 

2 

#  Wei 

3 

#  to 

4 

#  w1  = 

5 

#  u1  = 

6 

c 

7 

c 

8 

10.0 

9 

50.0 

10 

30.0 

11 

10.0 

12 

c 

13 

c 

14 

c 

15 

c 

16 

60.0 

17 

40.0 

18 

c 

19 

c 

20 

30.0 

21 

30.0 

22 

40.0 

Figure  5.5  Ranking  Weight  Parameter  File  Listing 


Table  5.5  Ranking  Weight  Field  Descriptions 


Line 
Number 

Entry 

Description 

1 

#ranking_weight_parameter_f i le 

o  File  type  identifier. 

o  This  line  cannot  be  changed;  otherwise,  the 

program  wi 1 1  not  run. 

2  -  7 

Comments 

o  Do  not  remove  any  comment  lines  from  the 
file;  these  lines  may  contain  instructions  or 
information  for  the  user. 

8  -  11 

Weight 
Weight 
Weight 
Weight 

o  Weights  for  objective  factors;  these  four 
weights  comprise  the  overall  rank, 
o  Note  that  a  rank  of  100  is  written  as  99  in 
the  reports  to  save  space. 

16  -  17 

Weight 
Weight 

o  Weights  for  bridge  condition. 

20  -  22 

Weight 
Weight 
Weight 

o  Weights  for  traffic  safety. 
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5.6  Ranking  Utility  Parameter  File 

The  disutility  functions  are  made  up  of  a  series  of 
equations  and  if-then  statements,  which  calculate  the 
disutility,  or  measure  of  the  bridge's  condition,  for 
several  factors  of  a  bridge  project.   These  factors  include 
economic  effectiveness  (E) ,  remaining  service  life  (R) , 
structural  condition  (S) ,  clear  deck  width  (C) ,  vertical 
clearance  (V) ,  inventory  rating  (I) ,  and  detour  length  (D) . 
Note  that  this  parameter  file  is  only  used  in  the  RANK 
program. 

Once  the  disutilities  are  determined  for  each  aspect, 
they  are  combined  and  weighted  to  form  a  total  disutility  of 
the  bridge  project;  refer  to  Chapter  5,  Section  5.   As  the 
disutility  increases,  the  urgency  for  repair  increases.   For 
a  more  detailed  discussion  of  disutility  functions,  see  the 
report,  FHWA/IN/JHRP-89/12,  "The  Development  of  Optimal 
Strategies  for  Maintenance,  Rehabilitation  and  Replacement 
of  Highway  Bridges,  Final  Report  Vol.  5:  Priority  Ranking 
Method,"  Chapter  3  (Saito  and  Sinha  1989).   A  program 
listing  of  the  file  is  included  in  Figure  5.6;  Table  5.6 
provides  an  overview  of  the  parameter  file. 
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#ranking_uti lity_parameter_f i le 


Economic  Effectiveness  Utility  Function  (E) 
adte  =  365*adt/cef 

std  =  standard  deviation  of  adte  for  all  bridges 
mean  =  average  adte  for  all  bridges 


1 

#ranki 

2 

# 

3 

# 

4 

# 

5 

# 

6 

c 

7 

c 

8 

c 

9 

c 

10 

c 

11 

c 

12 

3.0 

13 

50.0 

14 

c 

15 

c 

16 

c 

17 

c 

18 

c 

19 

c 

20 

c 

21 

c 

22 

c 

23 

5.0 

24 

15.0 

25 

150.0 

26 

10.0 

27 

c 

28 

c 

29 

c 

30 

c 

31 

c 

32 

c 

33 

c 

34 

3.0 

35 

8.0 

36 

160.0 

37 

20.0 

38 

c 

39 

c 

40 

c 

41 

c 

42 

c 

43 

c 

44 

c 

45 

c 

46 

c 

47 

-2.0 

48 

10.0 

49 

c 

50 

c 

51 

c 

52 

c 

53 

c 

54 

c 

55 

c 

56 

c 

57 

c 

58 

14.0 

59 

16.0 

60 

1600.0 

61 

100.0 

62 

2.0 

63 

12.0 

64 

14.0 

65 

1400.0 

66 

100.0 

67 

2.0 

68 

]  a1: 

if  (adte  <=  mean  -  a1*std  )  then 

]  a2: 

E  =  100.0 

else  if  (adte  >=  mean  +  a1*std)  then 

E  =  0.0 

else 


E  =  a2*[a1*std  -  (adte-mean)]/a1/std 


Remaining  Service  Life  Utility  Function  (R) 
ers  =  estimated  remaining  service  life  (yrs) 

]  b1:  if  (ers  <=  b1)  then 

]  b2:      R  =  100.0 

]  b3:  else  if  (ers  >  b1  and  ers  <  b2)  then 

]  b4:     R  =  b3  -  b4*ers 


else 


R  =  0.0 


Structural  Condition  Utility  Function  (S) 

scr  =  minimum  of  deck,  superstr.,  or  substr.  condition  ratings 


] 

el: 

if  (scr  <=  d)  then 

] 

c2: 

S  =  100.0 

] 

c3: 

else  if  (scr  >  d  and  scr  <  c2)  then 

] 

c4: 

S  =  c3  -  c4*scr 

else 


S  =  0.0 


Clear  Deck  Width  Utility  Function  (C) 

sddu  =  12*(number  of  lanes)  +  2  =  standard  deck  width 
cdw  =  clear  deck  width  (ft) 
diff  =  cdw  -  sddw 

]  d1:  if  (diff  <=  d1)  then 
]  d2:     C  =  100.0 

else  if  (diff  >=  d2)  then 

C  =  0.0 
else 

C  =  100  *  (diff-ud2)/(ud1-ud2) 

Vertical  Clearance  Utility  Function  (V) 
vc  =  vertical  clearance  (ft) 
e1  through  e5  are  used  for  major  hwys 
e6  through  e10  are  used  for  minor  hwys 


]  el: 

if  (vc  <=  e1)  then 

]  e2: 

V  =  100.0 

]  e3: 

else  if  (vc  >  e1  and  vc  <■ 

]  e4: 

V  =  (e3  -  e4*vc)  /  e5 

]  e5: 

else 

]  e6: 

V  =  0.0 

]  e7: 

]  e8: 

]  e9: 

]  e10 

c 

e2)  then 


Figure  5.6  Ranking  Utility  Parameter  File  listing 
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69 

c 

70 

c 

71 

c 

72 

c 

73 

c 

74 

5.0 

75 

25.0 

76 

125.0 

77 

5.0 

78 

c 

79 

c 

80 

c 

81 

c 

82 

c 

83 

c 

84 

c 

85 

5.0 

86 

50.0 

87 

20.0 

88 

100.0 

89 

9.0 

90 

c 

Note:  Line 

Inventory  Rating  Utility  Function  (I) 
ir  =  inventory  rating  (tons) 

]  f1:  if  (ir  <=  f1)  then 
]  f2:     I  =  100.0 

]  f3:  else  if  (ir  >  f1  and  ir  <  f2)  then 
]  f4:     I  =  f3  -  f4*ir 
else 

I  =  0.0 


Detour  Length  Utility  Function  (D) 
d  =  detour  length  (mi) 

]  g1:  if  (d  <=  g1)  then 

]  g2:     D  =  0.0 

]  g3:  else  if  (d  >  g1  and  d  <=  g2)  then 

]  g4:     D  =  (g3*d  -  g4)  /  g5 

]  g5:  else 

D  =  100.0 

numbers  are  for  reference  only;  they  do  not  appear  in  the  actual  parameter  file. 


Figure  5.6,  continued 


Table  5.6  Ranking  Utility  Field  Descriptions 


Line 
Number 

Entry 

Description 

1 

#ranking_uti lity_parameter_f i  le 

o  File  type  identifier. 

o  This  line  cannot  be  changed;  otherwise,  the 

program  will  not  run. 

2  -  11 

Comments 

o  Do  not  remove  any  comment  lines  from  the 
file;  these  lines  may  contain  instructions  or 
information  for  the  user. 

12  -  13 

a1 

a2 

o  Determine  E  by  comparing  average  daily 
traffic  effectiveness  with  the  mean  and 
standard  deviation  of  all  bridges. 

23  -  26 

b1...b4 

o  Determine  R;  depends  on  life  cycle  model  and 
repair  suggested  by  DTREE. 

34  -  37 

c1...c4 

o  Determine  S;  based  on  condition  rating  of 
superstructure,  substructure,  and  deck. 

47  -  49 

d1...d3 

o  Determine  C  by  comparing  clear  deck  width  to 
a  standard  width. 

56  -  60 

e1...e10 

o  Determine  V  by  comparing  standard  of  16'  and 
14'  vertical  clearance  for  major  and  minor 
highways,  respectively.' 

67  -  70 

f1...f4 

o  Determine  I . 

78  -  82 

gl...g5 

o  Determine  D. 

Vertical  clearance  for  bridges  over  water  are  assigned  a  default  value  or  specified  in  an 
exception  file;  see  Chapter  6. 
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5.7  Dollar  Conversion  Factor  Parameter  File 

All  cost  estimates  made  by  the  IBMS  are  in  dollar 
values  corresponding  to  a  particular  year,  which  will  be 
referred  to  as  the  base  year.   In  the  current  version  of  the 
IBMS,  all  cost  estimates  are  in  1985  dollars.   Therefore,  to 
make  the  reports  meaningful,  estimates  are  converted  to  the 
year  of  analysis,  using  the  dollar  conversion  factor 
parameter  file. 

The  dollar  conversion  parameter  file  allows  the  user  to 
specify  up  to  50  years,  along  with  their  corresponding 
conversion  factors.   Since  future  values  of  the  dollar  are 
unknown,  the  parameter  file  allows  new  factors  to  be  added 
when  available.   To  add  new  factors,  simply  follow  the 
format  of  the  existing  file.   A  program  listing  of  the  file 
is  shown  in  Figure  5.7;  Table  5.7  provides  an  overview  of 
the  parameter  file. 

Costs  can  be  converted  from  one  year  to  another  by 
taking  a  ratio  of  the  respective  conversion  factors,  which 
are  derived  from  FHWA's  "Price  Trends  for  Federal-Aid 
Highway  Construction,  Third  Quarter,  1991."   For  example,  to 
convert  a  1985  cost  of  $1000  to  1988  dollars,  the  following 
formula  is  used: 

1988  cost   =  (1985  cost)*  (1988  factor)  /  (1985  factor)      (3) 
Therefore,  1988  Cost  =  C$1000)  *  106.6  /  102.0  =  $1045.1 
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To  convert  costs  beyond  1991,  the  following  polynomial  is 
used: 

a+b(y-y0)  +c(y-y0)2+d(y-y0)2  +  e(y-y0)i  (4) 

where : 

a,b,c,d,e  =  coefficients  specified  in  parameter  file 

y  =  year  of  analysis 

y0  =  coefficient  specified  in  parameter  file 

This  polynomial  fit  was  based  on  data  from  1988  to  1991; 

these  values  can  be  modified. 
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1 

#doll 

ar  conversion 

_factors 

2 

#  Factors 

used  to 

:onvert  dollar  values  from  one  year  to  another. 

3 

#  You 

may 

append  years  to  this  list,  up  to  a  total  of  50. 

4 

#  Numbers 

are 

from 

FHUA  PRICE  TRENDS  for  FEDERAL-AID  HIGHWAY  CONSTRUCT 

5 

#  3rd 

qua 

•ter 

1991 

6 

. 

Polynomial  for  extending  range  beyond  end  of  list 

7 

. 

a  +  b(y-yo)  +  c(y-yo)**2  +  d(y-yo)**3  +  e(y-yo)**4 

8 

0.0 

]  yo  (use  a  real  number  here) 

9 

-290.45 

]  a  Equation  is  based  on  a  fit  of  the  data  for 

10 

0.2 

]  b  1988,  1989,  1990  and  1991. 

11 

0.0 

]  c 

12 

0.0 

]  d 

13 

0.0 

]  e 

14 

c 

15 

8.0 

Annual  interest  rate  for  cost  calculations 

16 

c 

17 

1985 

]  base  year  to  convert  to  and  from 

18 

102.0 

]  coefficient  for  base  year 

19 

c 

20 

1972 

]  first  year  of  list 

21 

38.6 

]  coefficient  for  first  year 

22 

c 

23 

1973 

]  second  year  of  list 

24 

42.5 

]  coefficient  for  second  year 

25 

c 

26 

1974 

]  etc... 

27 

57.9 

28 

c 

29 

1975 

30 

58.1 

31 

c 

32 

1976 

33 

56.3 

34 

c 

35 

1977 

36 

59.8 

37 

c 

38 

1978 

39 

70.7 

40 

c 

41 

1979 

42 

85.5 

] 

43 

c 

44 

1980 

45 

97.2 

46 

c 

47 

1981 

48 

94.2 

49 

c 

50 

1982 

51 

88.5 

52 

c 

53 

1983 

54 

87.6 

55 

c 

56 

1984 

57 

92.6 

58 

c 

59 

1985 

60 

102.0 

61 

c 

62 

1986 

63 

101.1 

64 

c 

65 

1987 

66 

100.0 

Figure  5.7  Lollar  Conversion  Factor  Parameter  File  Listing 
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67  c 

68  1988 

69  106.6 

70  c 

71  1989 

72  107.7 

73  c 

74  1990 

75  108.5 

76  c 

77  1991 

78  107.0 

Note:  Line  numbers  are  provided  for  reference  only;  they  do  not  appear  in  the  actual  parameter 
file. 

When  making  modifications,  avoid  using  tabs  and  do  not  add  or  remove  text  lines;  otherwise,  program 
results  may  be  unreliable. 


Figure  5.7,  continued 


Table  5.7  Dollar  Conversion  Field  Descriptions 


Line 
Number 

Entry 

Description 

'     1 

#dollar_conversion_f actors 

o  File  type  identifier. 

o  This  line  cannot  be  changed;  otherwise,  the 

program  will  not  run. 

2  -  7 

Comments 

o  Do  not  remove  any  comment  lines  from  the  file; 
these  lines  may  contain  instructions  or 
information  for  the  user. 

9  -  13 

yo 

a 
b 
c 
d 

e 

o  Values  for  the  polynomial  used  to  convert  to  and 

from  years  beyond  the  last  year  listed.' 

o  Conversion  factor  is  calculated  from  year  y, 

which  is  known. 

o  a  -  e  may  be  set  to  0. 

15 

Number 

o  Annual  percentage  rate  used  in  present  worth 

calculations. 

o  Written  as  8.0  or  5.0,  not  .08  or  .05. 

17  -  18 

Base  year 
Conversion  factor 

o  Cost  estimates  are  calculated  in  base  year 
dollars. 

20  -  21 

Year 
Conversion  Factor 

o  First  year  in  file  and  its  corresponding 
conversion  factor. 

23  -  24 

Year 
Conversion  Factor 

o  Second  year  in  file  and  its  corresponding 
conversion  factor. 

n  -  n+1 

Year 
Conversion  Factor 

o  Last  year  in  file  and  its  corresponding 
conversion  factor. 

1  This  polynomial  fit  was  based  on  data  from  1988  to  1991. 
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CHAPTER  6  EXCEPTION  FILES 


6 . 1  Introduction 

Exception  files  enable  the  user  to  control  how  programs 
in  the  IBMS  use  data  found  in  the  bridge  database.  These 
files  are  not  essential  for  normal  operation  of  the  system; 
they  merely  provide  additional  flexibility  and  control. 
Exception  files  allow  the  user  to  modify  information  in  the 
bridge  database,  and  thus,  override  decisions  made  by  DTREE 
and  influence  how  certain  actions  are  performed,  such  as 
bridge  widening.  Each  bridge  in  the  database  may  have  its  own 
exception  record.  To  use  these  files,  set  the  "Process 
Exceptions"  option  to  "y"  in  the  runfile;  refer  to  Chapter  4 
for  more  details. 

An  exception  record  consists  of  a  bridge  key  and  several 
data  fields.  The  bridge  key  (positions  1  through  9)  contains 
a  5-character  bridge  number  and  4-character  bridge 
designation.  Note  that  these  characters  may  include  blank 
spaces.  This  key  must  match  the  first  9  characters  of  the 
bridge  record  in  the  database  file  that  the  exception  record 
corresponds  to.  An  exception  record  can  be  created  by 
modifying  an  existing  exception  file,  found  in  the  directory 
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\bridge\examples,  using  the  exception  editor  described  in 
Chapter  7,  Section  2.9.  Be  sure  to  place  the  modified  file  in 
the  directory  \bridge\run  and  that  the  actual  exception  file 
name  and  the  name  found  in  the  runfile  match. 


6.2  File  Format 
An  exception  file  consists  of  one  or  more  exception 
records.  Each  record  consists  of  3  6  characters  and  is 
terminated  by  a  "new  line"  character.  Records  in  the  file 
must  be  sorted  by  the  bridge  key,  in  increasing  order; 
otherwise,  the  records  may  not  be  read.  The  exception  file 
may  be  sorted  with  the  program  EXPSORT.EXE,  found  in  the  IBMS 
Tools;  see  Chapter  7.2.6  for  more  information.  In  addition, 
the  searching  algorithm  which  locates  the  exception  records 
requires  that  an  exception  file  contain  no  more  than 
approximately  32,000  records. 


6.3  Record  Layout  and  Description 
The  format  for  each  record  is  listed  in  Table  6.1.  For 
the  record  to  be  valid,  each  exception  field  must  contain  at 
least  one  value  and  appear  in  the  proper  position.  However, 
all  fields,  except  for  the  bridge  key,  may  be  set  to  a  value 
which  will  cause  them  to  be  ignored;  see  Table  6.2  for  a 
summary  of  these  values.  Sample  records  can  be  found  in 
Appendix  F.  Exception  files  can  specify  six  functions:  repair 
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action,  repair  year,  bridge  length,  clear  deck  width,  approach 
length,    and  vertical   clearance. 

Table   6.1   Exception   Record   Format 


Field  Name 

Type 

Format 

Position 

of  Record 

( spaces) 

Bridge  Key 

alphanumeric 

a9 

1-9 

Exception  Action 

integer 

i2 

10-11 

Exception  Year 

integer 

i4 

12-15 

Exception  Bridge  Length 

integer 

i6 

16-21 

Exception  Bridge  Width 

real 

f5.1 

22-26 

Exception  Approach  Length 

integer 

16 

27-32 

Exception  Vertical  Clearance  (ft) 

integer 

i2 

33-34 

Exception  Vertical  Clearance  (in) 

integer 

i2 

35-36 

Note  that  each  exception  field  must  contain  at  least  one  value;  otherwise, 
unexpected  errors  or  results  may  occur.  When  the  positions  for  each  field 
are  not  completely  filled,  values  should  be  right-justified;  examples  are 
shown   in  Section   6.5 


Table   6.2   Valid  Values   for  Exception  Fields 


Field  Name 

Value  which 

ignores  exception 

field 

Value  which  overrides 

IBMS  decisions  or 

original  data 

Action 

<  0 

0  through  17 

Year1 

<  =  0 

4-digit  number 

Bridge  Length 

<  =  0 

>  0 

Bridge  Width 

<  =  0 

>  0 

Approach  Length 

<  =  0 

>  0 

Vertical  Clearance  (ft) 

<  =  0 

>  0 

Vertical  Clearance  (in) 

<  =  0 

>  0 

1  A  value  less  than  the  current  year  will  still  be  processed  by  DTRE^     but 
may  yield  unreliable  or  unreasonable  results. 
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6.3.1  Bridge  Key 
This  field  is  a  9-character  designation  shared  by  all 
programs  and  files  in  the  system.  The  key  in  the  exception 
record  must  match  the  key  in  the  bridge  record  that  the 
exception  record  corresponds  to.  It  is  possible  for  exception 
records  to  exist  with  keys  that  do  not  match  any  bridge  record 
in  the  database  file  being  analyzed;  however  these  exceptions 
will  not  affect  program  operation  in  any  way. 


6.3.2  Exception  Action 

Under  normal  system  operation,  the  module  DTREE  reads  the 
bridge  database  file  and  determines  which  action  (replace, 
rehabilitation,  or  do  nothing)  to  take.  However,  the 
"exception  action"  field  may  be  set  to  override  any  decision 
made  by  DTREE.  This  feature  is  useful  when  the  repair  action 
has  already  been  determined.  For  instance,  if  a  bridge  will 
never  be  replaced,  only  rehabilitated,  an  exception  record  can 
indicate  this  decision,  and  thus  avoid  overestimating  costs. 
To  indicate  when  and  what  action  is  performed  on  a  bridge,  an 
exception  record  can  specify  both  the  repair  action  and  year 
(see  Section  6.3.3  of  this  chapter). 

This  field  may  be  set  to  a  2-digit  integer  code  of  the 
action  desired,  with  possible  values  ranging  from  0  to  17;  see 
Appendix  H  or  Figure  2.2  for  an  explanation  oi  these  codes. 
A  value  greater  or  equal  to  zero  and  less  than  18  instructs 
DTREE  to  use  that  code  as  the  recommended  action  for  the 
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bridge;  hence,  DTREE  will  not  proceed  with  the  normal 
decision-making  process.  Conversely,  a  value  less  than  zero 
will  cause  the  field  to  be  ignored. 


6.3.3  Exception  Year 
Normally,  DTREE  will  recommend  the  year  for  which  any 
action  will  be  performed;  however,  a  4-digit  year  can  be 
specified  to  override  any  year  recommended  by  DTREE.  Note 
that  the  project  action  will  remain  the  same,  unless  the  user 
specifies  an  "exception  action."  If  a  value  less  than  zero  is 
assigned,  this  field  is  ignored,  and  DTREE  will  proceed  as 
normal  and  recommend  an  action  year.  Note  that  a  value  less 
than  the  current  year  will  still  be  processed  by  DTREE,  but 
may  yield  unreliable  or  unreasonable  results. 


6.3.4  Exception  Length 

If  the  "Lengthen  Bridges  with  exceptions  and  replace?" 

option  is  set  to  "y"  in  the  runfile,  the  bridge  length  will 

change  whenever  a  decision  specifies  a  bridge  replacement. 

Conversely,  to  leave  all  bridge  lengths  unchanged,  set  this 
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option  to  "n" .  This  6-digit  field  can  be  set  in  one  of  three 
ways;  if  the  value  is: 

a)  =  0,  the  bridge  is  lengthened  according  to  the 
curves  found  in  the  Recording  and  Coding  Guide, 
Item  76. 

b)  <  0,  the  length  will  remain  unchanged, 
regardless  of  how  options  are  set  in  the  runfile. 

c)  >  0,  the  length  will  be  set  to  the  value 
specified  in  the  exception  record. 

Note  that  a  bridge  may  be  lengthened  only  once  for  all  life 

cycle  calculations. 


6.3.5  Exception  Width 

If  the  "Widen  Bridges  with  exceptions  and  rehab?"  option 
is  set  to  "y"  in  the  runfile,  the  bridge  width  will  change 
whenever  an  action  specifies  bridge  widening.  Similarly,  if 
this  option  is  set  to  "n",  all  bridge  widths  remain  unchanged. 
Like  bridge  lengthening,  widening  can  only  occur  once  for  all 
life  cycle  calculations. 

The  options  for  this  field  are  similar  to  those  of  the 
"exception  length,"  in  Section  6.3.4  of  this  chapter.  This  6- 
digit  field  can  be  set  in  one  of  three  ways;  if  the  value  is: 

a)  =0,  the  bridge  is  widened  according  to  an 
internal  subroutine  called  "WidenBridge, "  found  in 
the  program  EXTEND. FOR. 

b)  <  0,  the  width  will  remain  unchanged,  regardless 
of  how  options  are  set  in  the  runfile. 

c)  >  0,  the  width  will  be  set  to  the  value 
specified  in  the  exception  record. 
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6.3.6  Exception  Approach  Length 
Bridge  approach  length  is  used  to  estimate  the  costs  of 
certain  actions;  however,  this  value  is  not  available  in  the 
main  bridge  inventory  database,  since  it  is  an  estimated 
length  of  approach  work  for  a  proposed  bridge  project. 
Therefore,  the  IBMS  assigns  a  default  value  of  100  feet  for 
all  bridges.  However,  if  an  exception  record  specifies  a 
positive  non-zero  approach  length,  this  value  will  replace  the 
default  value.  Conversely,  a  value  less  than  or  equal  to  zero 
causes  this  field  to  be  ignored;  thus,  the  default  value  of 
100  feet  will  be  used. 


6.3.7  Exception  Vertical  Clearance 
Although  vertical  clearance  is  specified  in  the  bridge 
database,  this  field  has  a  value  of  zero  for  bridges  over 
water.  In  these  cases,  the  IBMS  assigns  a  default  value  of  i6 
feet  for  the  vertical  clearance,  for  both  major  and  minor 
highways.  However,  if  an  exception  record  specifies  a 
positive  non-zero  vertical  clearance,  this  value  replaces  the 
vertical  clearance  in  the  bridge  record,  regardless  of  the 
value  specified  in  the  bridge  record.  If  a  value  less  than  or 
equal  to  zero  is  specified,  this  field  is  ignored. 


6.4  Using  Exception  Files 
The  user  may  specify  two  types  of  exception  files: 
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primary  and  secondary  exception  files.  The  primary  exception 
file  contains  a  set  of  exception  records  which  may  change 
occasionally,  while  the  secondary  exception  file  contains 
records  that  change  frequently. 

During  program  execution,  both  exception  files  are 
opened.  When  a  bridge  record  is  read  from  the  database,  the 
program  searches  both  exception  files  for  the  bridge  key  in 
the  database.   Certain  rules  are  followed  during  this  search: 

1)  If  no  exception  record  is  found  in  either  file, 
processing  continues  as  usual. 

2)  If  an  exception  record  is  found  in  only  one  of  the 
exception  files,  primary  or  secondary,  this  file  is  used 
as  described  in  Section  6.3  of  this  chapter. 

3)  If  an  exception  record  is  found  in  both  files, 
information  in  the  secondary  exception  file  takes 
precedence.  However,  if  any  fields  in  the  secondary  file 
are  set  to  values  that  would  cause  these  fields  to  be 
ignored,  then  values  in  those  same  fields  in  the  primary 
file  are  used. 

This  method  establishes  a  semi-permanent  database  of  exception 
records,  found  in  the  primary  exception  file.  Thus,  if  the 
user  wishes  to  modify  the  primary  file,  one  can  easily  create 
a  secondary  exception  file  with  the  new  information. 

As  described  earlier,  the  primary  exception  file  contains 
records  which  do  not  change  frequently.  Consequently, 
exception  records  for  approach  length  and  vertical  clearance 
should  be  placed  in  this  file,  since  they  rarely  change,  if  at 
all.  Similarly,  for  bridges  which  almost  always  have  the  same 
repair  performed,  include  an  "exception  action"  in  this  file. 
Any  other  information  known  to  be  relatively  constant  should 
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be  included  in  the  primary  file.  Typically,  this  exception 
file  will  be  created  once,  with  minor  modifications  made  when 
necessary. 

The  secondary  exception  file  contains  records  which  often 
change.  This  file  is  typically  smaller  than  the  primary  file, 
which  may  contain  thousands  of  records,  and  used  on  a  short 
term  basis.  Consequently,  the  secondary  file  can  be  easily 
modified  when  changes  are  desired  for  the  current  bridge 
analysis. 

Both  exception  files,  primary  and,  secondary,  can  be 
controlled  by  setting  options  in  the  runfile.  To  disable  both 
exception  files,  set  the  "Process  Exceptions"  option  in  the 
runfile  to  "n".  Similarly,  to  disable  the  second  exception 
file  only,  set  the  "Use  Second  Exception  File"  option  in  the 
runfile  to  "n" . 

All  exception  files  must  be  named;  default  file  names 
have  been  provided  in  the  runfile  for  the  primary  and 
secondary  exception  files:  EXCEPT. EXP  and  EXCEPT2.EXP, 
respectively.  Each  time  an  exception  record  is  used,  a  flag 
is  set  in  the  reports  file  to  indicate  that  an  exception  has 
been  processed. 


6.5  Examples 
Several  examples  of  exception  files  are  listed  below.- 
Note  that  each  file  conforms  to  the  standards  discussed 
previously  in  Section  6.3  of  this  chapter.   Sample  files  can 
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be  found  in  the  directory  \bridge\examples.  Once  exception 
files  have  been  created,  they  can  be  edited  using  the  program 
EXEDIT.EXE;  see  Chapter  7  for  more  information. 


6.5.1  Case  1 

Bridge  04236ABCD  will  not  be  replaced  in  the  near  future; 

however,   its   condition  may   cause   DTREE   to   suggest   a 

replacement,  producing  overestimated  cost  calculations.   To 

avoid  this  situation,  prepare  an  exception  record  with  the 

following  information: 

Bridge  Key  -   04236ABCD 

Exception  Action  -  code  indicating  a  rehabilitation,  say 

1,  Deck  Rehabilitation,  for  example. 

Other  codes  are  set  to  values  which  cause  them  to  be  ignored; 

hence,  the  exception  record  would  appear  as  follows: 

1    5    10    15    20    25    30    35    40 

04236ABCD  10      0   0.0      0  0  0 

This  record  is  placed  in  a  primary  exception  file  so  that 
this  exception  information  will  remain  in  the  database  upon 
each  program  execution;  use  of  this  record  will  be  flagged  in 
all  reports  to  remind  the  user. 


6.5.2  Case  2 
The  user  knows  that  bridge  98765ZYXW  will  be  replaced  in 
2000.   An  exception  record  is  prepared  with  the  following 
information: 
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Bridge  Key  -  98765ZYXW 

Exception  Action  -  16,  the  IBMS  code  for  replace 

Exception  Year  -  2000. 

Other  fields  in  the  exception  record  are  set  to  values  which 
cause  them  to  be  ignored;  hence,  the  exception  record  would  be 
written: 

1    5    10    15    20    25    30    35    40 

+ + + + + + + + 

98765 ZYXW162000      0   0.0      0  0  0 

If  the  "Process  Exceptions"  options  is  set  to  "y"  in  the 
runfile,  DTREE  will  use  this  information  as  the  repair  code 
and  year;  other  modules  in  the  system  will  also  perform 
calculations  based  on  this  exception  record. 

6.5.3  Case  3 

The  user  plans  to  set  the  "Lengthen  Bridges  on  Replace" 
in  the  runfile  to  "y",  causing  bridges  to  be  lengthened  when 
replacements  are  specified.  The  user  also  knows  that  bridges 
22222CS  and  88888AB  will  never  be  lengthened,  bridge  33333 
must  be  lengthened  to  600  feet,  and  bridge  55555XX  will  be 
reduced  to  75  feet. 

In  this  case,  records  will  be  created  in  both  the  primary 
and  secondary  exception  files.  Since  the  user  knows  that  the 
lengths  will  never  change  for  bridges  22222CS  and  88888AB,  two 
separate  records  are  created  in  the  primary  file,  with  the 
following  information: 

Exception  Length  =  -1 
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Similarly,  two  records  are  created  in  the  secondary  exception 

file  with  the  following  information: 

Exception  Length  =  75,  for  bridge  55555XX 
Exception  Length  =  600,  for  bridge  33333 

These  records  would  appear  as  follows: 


1    5 

10 

15 

20 

25 

30 

35 

40 

22222CS 

0 

0 

-1 

0.0 

0 

0  0 

88888AB 

0 

0 

-1 

0.0 

0 

0  0 

55555XX 

0 

0 

75 

0.0 

0 

0  0 

33333 

0 

0 

600 

0.0 

0 

0  0 

6.5.4  Case  4 

Bridge  7878  has  an  approach  length  of  3000  feet.  If  the 
default  approach  length  is  used,  cost  calculations  will  be 
underestimated.  Therefore,  the  user  prepares  an  exception 
record  in  the  primary  file,  with  an  "exception  approach 
length"  of  3  000.  Since  this  value  is  placed  in  the  primary 
file,  the  correct  approach  length  will  be  used  whenever  the 
program  is  executed.  This  primary  record  appears  in  the 
following  format: 

1    5    10    15    20    25    30    35    40 

7878       0    0      0   0.0   3000  0  0 

Suppose  the  user  wants  to  determine  the  cost  for  a 
different  approach  length,  say  2000  feet.  Leaving  the  primary 
exception  file  intact,  an  exception  record  for  7878  is  created 
in  a  secondary  exception  file  called  EXGUESS. EXP,  for  example, 
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with  an  "exception  approach  length"  of  2  000.  The  secondary- 
record  is  similar  to  the  primary,  with  the  following 
modification: 

1    5    10    15    20    25    30    35    40 

+ + + + + + + + 

7878       0    0      0   0.0   2000  0  0 

The  option  "Use  Second  Exception  File"  is  set  to  "y"  in  the 

runfile  and  the  file  name  EXGUESS.EXP  is  entered  at  the 

appropriate  place  in  the  runfile.  Upon  execution,  the  program 

finds  both  exception  records  for  7878;  however,  as  described 

previously  in  Section  4  of  this  chapter,  the  secondary  file 

overrides  any  information  in  the  primary  file.  Therefore,  the 

approach  length  of  2000  is  used,  rather  than  3000. 


6.5.5  Case  5 
Bridge  99999Z  is  a  bridge  over  water;  consequently,  a 
vertical  clearance  of  0  is  assigned  in  the  database  record  for 
this  bridge.  In  reality,  the  bridge  is  known  to  be  95  feet 
above  the  water.  If  the  default  vertical  clearance  is  used, 
substructure  costs  will  be  underestimated.  To  avoid  this 
problem,  the  user  adds  a  record  to  the  primary  exception  file 
and  sets  the  "exception  vertical  clearance"  to  95,  so  that  the 
correct  vertical  clearance  is  used  upon  each  program 
execution;  the  record  would  be  written: 

1    5    10    15    20    25    30    35    40 

+ + + + + + + + 

99999Z     0    0      0   0.0      095  0 
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CHAPTER  7  IBMS  TOOLS 


Several  tools  are  available  to  make  the  IBMS  more 

convenient  to  use.   The  IBMS  Tools  include  the  following: 

1.  Print  and/or  check  bridge  database  file 

2.  Print  and/or  check  exception  file 

3.  Format  .txt  file  for  printer 

4.  Sort  a  Bridge  Database  File  (.dat) 

5.  Sort  an  Exception  File  (.exp) 

6.  Sort  a  Text  Report  (.txt) 

7 .  Generate  a  Year-Sum  Report 

8.  Split  a  .txt  file  into  head,  body,  and  tail 

9.  Edit  an  Exception  File 

10.  View  Reports 


7.1  Setting  Up  the  IBMS  Tools 
The  installation  process  described  in  Chapter  3  lists  the 
files  needed  to  execute  these  tools;  however,  the  user  must 
set  up  the  IBMS  Tools  program  group  in  the  OS/2  Window,  which 
was  described  previously  in  Chapter  3.  The  files  for  the  IBMS 
tools  are  found  on  IBMS  Disk#2  and  a  listing  of  these  programs 
and  their  location  are  given  in  Table  7.1.  Note  that  these 
instructions  were  written  specifically  for  version  2.0  of 
OS/2;  however,  set-up  procedures  for  other  versions  should  be 
similar.  For  more  information  about  instaxling  programs, 
refer  to  "IBM  Operating  System/2  Standard  Edition  Version  2.0 
Getting  Started,"  Chapter  3. 
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7.2  Running  the  IBMS  Tools  from  the  Icon  View 

7.2.1  Print  and/or  Check  Bridge  Database  File 
This  tool  (PRBRIDGE.CMD)  separates  the  fields  in  a  bridge 
database  file,  allowing  the  user  to  easily  view  or  print  the 
contents  of  the  file. 

After  the  program  is  selected,  all  files  with  the  .dat 
extension  in  the  directory  \bridge\bridge  are  listed.  The 
output  file  name  can  be  any  eight-letter  name,  with  a  three- 
letter  extension.  Typically,  the  name  of  the  bridge  file  is 
used,  along  with  the  .txt  extension.  If  the  "map  records" 
option  is  selected,  the  program  will  convert  codes  from  the 
Recording  and  Coding  Guide  to  codes  used  by  the  IBMS;  see 
Chapter  2,  Section  6.  The  next  option  checks  the  file  for 
errors;  if  selected,  a  list  of  all  errors  will  be  printed  at 
the  end  of  the  file.  If  the  map  and  check  records  options  are 
selected,  the  words  "Mapped"  and  "Checked"  will  appear  at  the 
top  of  the  new  file. 

After  the  program  is  executed,  if  the  .txt  extension  is 
specified,  the  output  file  will  be  moved  to  the  directory 
\bridge\reports;  otherwise,  the  file  will  remain  in  the 
\bridge\ bridge  directory. 


7.2.2  Print,  and/ or  Check  Exception  File 
This  tool  (PRINTEXE.CMD)  is  similar  to  the  one  described 
in  the  preceding  paragraph,  only  exception  files  are  formatted 


89 
for  printing. 

After  the  program  is  selected,  a  list  of  all  .exp  files 
in  the  directory  \bridge\run  will  be  generated.  Again,  the 
output  file  name  can  be  any  eight-letter  name  with  a  three- 
letter  extension,  but  typically,  the  name  of  the  exception 
file  will  be  used,  with  the  .txt  extension.  The  next  option 
checks  for  errors,  such  as  duplicate  records  and  whether  or 
not  the  records  are  sorted  by  bridge  number.  These  errors 
will  be  listed  at  the  end  of  the  file.  If  this  option  is 
selected,  the  word  "Checked"  will  appear  at  the  top  of  the  new 
file. 

After  the  program  is  executed,  if  the  .txt  extension  is 
specified,  the  file  will  be  moved  to  the  \bridge\reports 
directory;  otherwise,  it  will  remain  in  the  \bridge\run 
directory. 


7.2.3  Format  .txt  File  for  Printer 
This  tool  (PRFORMAT.CMD)  formats  a  report  to  be  printed 
on  an  8-1/2"  by  11"  page. 

After  the  program  is  selected,  a  list  of  all  .txt  files 
in  the  directory  \bridge\reports  is  provided.  The  output  file 
can  be  any  eight-letter  name  and  three-letter  extension; 
however,  do  not  specify  a  .txt  extension  or  the  original  file 
will  be  overwritten.  The  file  will  be  formatted  for  65  lines 
per  page  unless  specified  otherwise.  After  execution,  the 
file  can  be  found  in  the  reports  directory.   The  formatted 
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file  can  then  be  printed  with  a  text  editor,  such  as  the  OS/2 
System  Editor,  or  a  word  processing  program. 

7.2.4  Sort  a  Text  Report  (.txt) 

This  tool  (TEXTSORT.CMD)  sorts  a  report  according  to 

different  parameters,  such  as  bridge  number,  cost,  rank,  etc. 

After  the  program  is  selected,  a  list  of  all  .txt  files 

in  the  \bridge\reports  directory  is  provided.   The  report  can 

be  sorted  by  two  sort  keys:  primary  and  secondary.    The 

available  parameters  are  listed  below;  "N/A"  means  that  the 

parameter  is  not  available  and  "Nothing"  tells  the  program  not 

to  sort  the  file. 

N/A:  Route  Number  8:  EUAC 

2 :  Bridge  Number  9 :  CEF 

3:  District  10:  Rank 

4:  County  11:  Rank  After 

5:  Action  Year  12:  Delta  Rank 

6:  Action  Code  13:  Nothing 

7:  Project  Cost 

The  file  is  sorted  and  saved  within  the  file  specified  in  Step 

3  and  can  be  found  in  the  \bridge\reports  directory. 

7.2.5  Sort  a  Bridge  Database  File  (.dat) 
This  tool  (DATASORT.CMD)  is  similar  to  the  one  described 
in  the  preceding  section,  only  it  sorts  a  bridge  database 
file. 

After  the  program  is  selected,  a  list  of  all  .dat  files 
in  the  \bridge\bridge  directory  is  provided.  The  report  can 
be  sorted  by  two  sort  keys:  primary  and  secondary.  The 
available  parameters  are  listed  below;  "N/A"  means  that  the 


91 

parameter  is  not  available  and  "Nothing"  tells  the  program  not 

to  sort  the  file. 

1:  Route  Number  N/A:  EUAC 

2:  Bridge  Number  N/A:  CEF 

3:  District  N/A:  Rank 

4:  County  N/A:  Rank  After 

N/A:  Action  Year  N/A:  Delta  Rank 

N/A:  Action  Code  13:  Nothing 

N/A:  Project  Cost 

The  file  is  sorted  and  saved  within  the  file  specified  in  Step 

3  and  can  be  found  in  the  \bridge\bridge  directory. 


7.2.6  Sort  an  Exception  File  (.exp) 
Exception   files  must  be   sorted  by  bridge  number; 
otherwise  unexpected  results  or  errors  may  occur.   Therefore, 
this  tool  (EXPSORT.CMD)  sorts  an  exception  file  only  by  bridge 
number . 

After  the  program  is  selected,  a  list  of  all  .exp  files 
in  the  \bridge\run  directory  is  provided.  "N/A"  means  that 
the  parameter  is  not  available  and  "Nothing"  tells  the  program 
not  to  sort  the  file.  The  file  is  sorted  and  saved  within  the 
file  specified  in  Step  2  and  can  be  found  in  the  \bridge\run 
directory. 
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7.2.7  Generate  a  Year-Sum  Report 

This  tool  (COSTSUM.CMD)  computes  the  cumulative  total 
each  year  for  four  parameters:  cost,  EUAC,  CEF,  and  delta 
rank.  The  first  three  parameters  calculate  cumulative  totals 
for  projects  selected  by  DTREE,  COST,  and  RANK.  The  delta 
rank  parameter  applies  only  to  RANK;  it  computes  the 
cumulative  total  of  the  change  in  disutility  before  and  after 
a  repair. 

After  the  program  is  selected,  a  list  of  all  .txt  files 
in  the  directory  \bridge\reports  is  provided.  The  output  file 
name  should  be  different  from  the  input  file;  otherwise,  the 
input  file  will  be  overwritten.  If  the  output  file  is  used  as 
an  input  file  for  another  summary,  the  new  sum  will  be 
appended  to  the  new  output  file.  Since  a  cumulative  total  is 
found  for  each  year,  the  input  file  should  be  sorted  by  action 
year. 


7.2.8  Split  a  .txt  Report  into  Head,  Body,  and  Tail 
This  tool  (SPLIT.CMD)  separates  a  text  report  into  its 
three  components:  head,  body,  and  tail.  The  head  of  a  report 
contains  all  text  above  the  first  "cut  mark"  or  five  or  more 
dashes;  typically,  the  head  consists  of  the  report  headers. 
The  body  of  a  report  contains  all  text  between  the  cut  marks 
or  the  end  of  the  file.  The  tail  of  a  report  contains  the 
text  found  beneath  the  next  cut  mark  or  the  end  of  the  file. 
After  the  program  is  selected,  a  list  of  all  .txt  files 
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in  the  directory  \bridge\reports  is  provided.  The  new  files 
can  also  be  found  in  the  directory  \bridge\reports. 

HEAD 


BODY 



TAIL 
Figure  7.1  Diagram  of  Head,  Body,  and  Tail 

7.2.9  Edit  an  Exception  File 
It  is  important  that  exception  files  follow  the  format 
described  in  Appendix  F  and  Chapter  6;  otherwise,  unexpected 
results  or  errors  may  occur.  This  tool  (EXEDIT.EXE)  allows 
the  user  to  edit  exception  files,  while  observing  the  required 
format.  This  editor  consists  of  one  main  menu  and  four  sub- 
menus: file,  edit,  move,  and  quit.  The  user  may  exit  from 
any  of  the  sub-menus  by  pressing  the  enter  key;  to  exit  from 
the  main  menu,  hit  "q"  for  quit  and  then  "q"  again  or  press 
the  control  and  escape  keys  simultaneously.  Instructions  for 
using  this  tool  to  edit  and  save  an  existing  file  are  listed 
below.  See  Table  7.2  for  a  description  of  the  commands  for 
each  menu. 
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Table  7.2  Exception  File  Editor  Commands 


Sub-Menu 

Command 

Description 

File 

New 

create  a  new  file 

Load 

load  an  existing  file 

Save 

save  revisions  under  same  file  name 

Save  as 

save  revisions  under  new  file  name 

Merge 

combine  two  files 

Exit 

quit  file  mode 

Edit 

Add 

add  new  record 

Edit 

modify  current  record 

Restore 

undo  last  change 

Delete 

erase  current  record 

Undelete 

unerase  last  record  erased 

Exit 

quit  edit  mode 

Move 

Search 

locate  specific  record  by  bridge 
number 

Up 

locate  previous  record 

Down 

locate  next  record 

Home 

move  to  first  record  of  file 

End 

move  to  last  record  of  file 

Quit 

Quit 

exit  editor 

Cancel 

remain  in  editor 
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Exception   files   can   be   found   in   the   \bridge\run 
directory.  To  edit  a  file  from  another  directory  or  diskette, 
the  full  path,  file  name,  and  extension  must  be  specified. 


7.2.10  View  Reports 

This  tool  (LIST. EXE)  allows  the  user  to  examine  a  report. 
The  program  list.exe  is  a  read-only  program  that  allows  the 
user  to  view  the  contents  of  any  ASCII  file. 

This  program  is  configured  to  read  files  in  the  directory 
\bridge\reports;  if  the  user  wishes  to  view  a  file  in  another 
directory,  simply  type  the  full  path  name,  along  with  the 
file  name  and  extension.   For  example,  type 
c: \bridge\bridge\bridge.dat. 

Within  the  list  program,  the  user  can  view  another  file 
by  typing  "f"  and  then  the  file  name  and  extension.  To  exit, 
press  the  escape  key. 


7.3  Running  the  IBMS  Tools  from  the  OS/2  Prompt 
To  use  the  IBMS  Tools  from  the  OS/2  prompt,  the  user  must 
be  in  the  following  directory:  \bridge\prog.  To  run  a  tool, 
type  the  name  of  the  file,  along  with  the  .cmd  extension,  then 
follow  the  instructions  specified  in  Section  7.2  of  this 
chapter . 

The  .cmd  file  is  a  batch  file  that  provides  a  set  of 
instructions  for  the  actual  program  (.exe  file).   If  the  .cmd 
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extension  is  not  specified,  the  executable  file  will  be  run 
directly.  If  this  occurs,  the  full  path  must  be  entered  when 
prompted  for  a  file  name.  Similarly,  if  a  path  is  not 
specified  for  the  output  file,  it  will  be  placed  in  the 
\bridge\prog  directory.   An  example  is  shown  in  Chapter  8. 
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CHAPTER  8  EXAMPLE  RUN  OF  THE  IBMS 


This  chapter  provides  the  step-by-step  procedure  for 
running  the  entire  IBMS  project  evaluation  package  from  the 
OS/2  prompt.  Instrumentation  for  running  the  package  from  the 
Icon  View  are  similar;  refer  to  Chapter  3,  Section  5.  The 
sequential  order  of  the  results  shown  depend  on  the  ordering 
of  the  bridge  data  base  used.  Individual  results  may  differ 
from  the  example  shown  here. 

8.1  Bridge  Database  File 
The  first  step  is  to  prepare  a  bridge  database  file,  as 
explained  in  Appendix  F.l,  and  copy  it  to  the  directory 
\bridge\bridge.  See  Table  8.1  for  the  bridge  data  base  format. 
The  file  used  for  this  example  contains  fifteen  bridges; 
however,  the  IBMS  has  been  tested  successfully  with  a  database 
of  5000  bridges.  The  example  file  is  called  TEST. DAT;  see 
Figure  8.1.  The  database  file  can  be  "mapped,"  as  described 
in  Chapter  2,  Section  6,  and  then  printed  with  the  IBMS  Tools, 
so  that  the  data  is  more  meaningful.  The  mapping  procedure  is 
shown  in  Figures  8.2  and  8.3;  the  mapped  file  can  be  found  in 
Figure  8.4.   See  Table  8.2  for  a  complete  description  of  the 
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02270890 1363A 
003307102037 
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041 9291 991 062003800020487044800003000001 02061 298658  9004 
051947198506200130002034302800001620000102081316665  9008 
031938197307400150002037403430001262108602021325756359108 
0419360000  00018001600001321402303007006766358912 
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Figure  8.1  Test.dat 


Table  8.1  Test.dat  Format 


Position 

Description 

1-4 

highway  route  number 

5-7 

county  code 

8-12 

bridge  number 

13-16 

bridge  designation 

17-18 

highway  dept.  district  code 

19-22 

year  of  original  construction 

23-26 

last  year  bridge  was  repaired 

27-28 

functional  class  code 

29 

hwy  system  of  inventory  route 

30-35 

average  daily  traffic  (ADT) 

36-37 

number  of  traffic  lanes 

38-41 

total  deck  width  (ft) 

42-45 

clear  deck  width  (ft) 

46-51 

bridge  length  (ft) 

52-53 

vertical  clearance  (ft) 

54-55 

vertical  clearance  (in) 

56 

superstructure  material 

57-58 

superstructure  construction 

59-60 

detour  length  (mi) 
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Table  8.1,  continued 


Position 

Description 

61 

type  of  load 

62-63 

inventory  rating  (tons) 

64 

main  deck  surface  condition  rating 

65 

superstructure  condition  rating 

66 

substructure  condition  rating 

67 

deck  geometry  code 

68-69 

proposed  work  code 

70-73 

date  of  last  inspection  (yr /month) 

[A; \BRIDGE\PROG]prbridge 
Print  Bridge  Database 

Enter  Bridge  File  name:  a:\bridge\bridge\test.dat 

Enter  Output  File  name:  a:\bridge\reports\test.txt 

Map  Records  Before  Printing?  (y/n)  y 

Check  Records?  (y/n)  y 

Successful  completion,  file  written  to  a:\bridge\reports\test.txt 

Hit  Enter  to  continue... 
[A:\BRIDGE\PROG] 


Figure  8.2  Running  Prbridge.exe 


100 
[A: \BRIDGE\PROG3prbridge.cmd 
INDOT  BMS  Bridge  File  List  and  Check  (PRBRIDGE) 

Bridge  Files  in  \BRIDGE\BRIDGE  : 


Volume  in  drive  A  is  BMS-OS2 
Volume  Serial  Number  is  6574-4414 
Directory  of  A:\BRIDGE\BRIDGE 

TEST . DAT 

1  file(s)        750  bytes 

57856  bytes  free 

• 

Remember  the  file  name  to  be  used.   If  you  need  to  see 
it  again,  run  the  program  over. 
Press  any  key  to  continue... 


Print  Bridge  Database 

Enter  Bridge  File  name:  test.dat 

Enter  Output  File  name:  test.txt 

Map  Records  Before  Printing?  (y/n)  y 

Check  Records?  (y/n)  y 

Successful  completion,  file  written  to  test.txt 

Hit  Enter  to  continue. . . 

Moving  .txt  report  generated  to  \BRIDGE\REPORTS 


TEST.TXT 

1  file(s)  copied 


Press  any  key  to  continue. . . 
[A:\BRIDGE\PROG] 

Figure  8.3  Running  Prbridge.cmd 
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mapped  bridge  file  format. 

Note  that  four  bridges  contained  fatal  errors,  indicating 
that  information  needed  for  program  calculations  was  bad  or 
missing.  Nonfatal  errors  occur  when  data  does  not  conform  to 
the  NBIS,  but  does  not  interfere  with  program  operation. 


8.2  Runfile 
The  runfile  used  in  this  example  is  called  "test. run; "  see 
Figure  8.5.  This  runfile  was  created  by  duplicating  the  default 
runfile  (RUNFILE. RUN) ,  found  in  the  directory  \bridge\run  or 
\bridge\ examples,  changing  the  bridge  database  file  name  to 
TEST. DAT,  and  then  saving  the  runfile  under  the  name  TEST. RUN. 
These  modifications  were  made  using  the  OS/2  System  Editor. 
Note  that  the  "Process  Exceptions"  and  "Lengthen  and  Widen 
Bridges"  options  are  set  to  "n."  Remember  that  the  runfile 
should  be  copied  to  the  directory  \bridge\run. 


8.3  DTREE 
The  next  step  is  to  run  DTREE,  as  shown  in  Figure  8.6.  In 
addition,  the  text  report,  log  file,  output  Tile,  and  Lotus-12  3 
file  are  provided  in  Figures  8.7,  8.8,  8.9,  and  8.10, 
respectively.  Formats  of  the  outputs  of  DTREE.TXT  and  DTREE. OUT 
are  given  in  Tables  8.3  and  8.4.   At  this  point,  the  IBMS  simply 


Table  8.2  Description  of  Mapped  Test.dat 
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Heading 

Description 

Route 

Route  number 

Co. 

County  code 

Br  #  des 

Bridge  number  and  designation 

Dis 

District  code 

YrBlt 

Year  bridge  was  constructed 

Fixed 

Year  of  last  repair 

FC 

Functional  classification 

Hwy 

Highway  system  of  the.  inventory  route 

ADT 

Average  daily  traffic 

Lns 

Number  of  lanes 

DkWid 

Deck  width 

ClWd 

Clear  deck  width 

Length 

Length  of  bridge 

Vft 

Vertical  clearance,  ft 

Vin 

Vertical  clearance,  in 

SM 

Superstructure  material 

SC 

Superstructure  construction 

Det 

Detour  length 

IR 

Type  of  load 

Ton 

Inventory  rating 

DC 

Deck  condition 

SC 

Superstructure  condition 

sC 

Substructure  condition 

DG 

Deck  geometry  code 

WK 

Proposed  work  code 

IDate 

Last  inspection  date 

DeckT1 

Deck  type 

1  This  field  is  not  used  in  the  current  IBMS, 


104 


#run  file 

# 

# 

it 

y 
y 
y 

y 

n 

c 
n 


bridge.dat 
default 
except. exp 

except 2. exp 

c 

dtree 
dtree.par 

c 

dtree. out 
cost 
life. par 
cost. par 

c 

cost. out 
rank 

weight. par 
utility. par 

c 

rank. out 
opt 
opt. par 

c 

dollar. par 
default 


All:  Print  text  reports?  (y/n) 

All:  Print  123  reports?  (y/n) 

All:  Print  log  file?  (y/n) 

All:  Check  bridge  records?  (y/n) 

All:  Process  exceptions?  (y/n) 

Dtree:  Report  Style  (n)ormal  (c)ondition  (e)xception 

Dtree:  Use  second  exception  file?  (y/n) 

Dtree: 

Dtree: 

Dtree: 

Cost:  Style  (n)orm  pres(w)orth  (l)ookahead  (p)wlookahead 

Cost:  Do  maintenance  cost  calculations?  (y/n) 

Cost:  Lengthen  Bridges  with  exceptions  and  replace?  (y/n) 

Cost:  Widen  Bridges  with  exceptions  and  rehab?  (y/n) 

Cost: 

Rank:  Report  style  (n)ormal  (u)tility 

Rank: 

Rank: 

Rank: 

Rank: 

Opt: 

Opt: 

Opt: 

Opt: 

Opt: 

reserved 

reserved 

reserved 

reserved 

reserved 

Bridge  database  files 
Bridge  data  file  from  \bridge\bridge 
Bridge  index  file  from  \bridge\bridge 
Primary  exception  file 
Secondary  exception  file 


Decision  tree  program  files 

File  prefix  for  .out  .txt  .prn  .log  output  files 
Parameter  file:  defines  decision  criteria  (must  have 


.par) 


Economic  analysis  program  files 
Input  file  for  cost  analysis 

File  prefix  for  .out  .txt  .prn  .log  output  files 
Life  cycle  model  parameters  (must  have  .par) 
Cost  estimate  coefficient  parameter  file 

Ranking  program  files 
Input  file  for  ranking 

File  prefix  for  .out  .txt  .prn  .log  output  files 
Ranking  weights  (must  have  .par) 
Distility  function  parameters  (must  have  .par) 

Optimization  program  files 
Input  file  for  optimization 
File  prefix  for  .txt  .prn  .log  output  files 
Optimization  parameters  (must  have  .par) 

Other  files 

Interest  rate  and  S  conversf-..  factors  (must  have  .par) 
Log  File  (overrides  log  file  name  from  above) 


Figure  8.5  Test. run 
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[A: \BRIDGE\PROG]dtree 
DECISION  TREE  PROGRAM 

. . . initializing 
Enter  runfile  name  [default]  a:\bridge\run\runtest.run 

Enter  year  of  analysis:  1992 

Enter  report  style  (n,c,e)  [c]  c 

Process  exceptions  [n]  n 

...processing  bridge  file  records 
Errors  in  bridge  record  02037      1  fatal  and  2  nonfatal, 
Errors  in  bridge  record  05289A     1  fatal  and  0  nonfatal, 
Errors  in  bridge  record  07558      6  fatal  and  0  nonfatal, 
Errors  in  bridge  record  07710SBL   1  fatal  and  2  nonfatal, 

Total  Records  Successfully  Processed  11 
Total  Errors  In  Processing  Records  4 
Decision  Count 


Nothing 
Deck  Rehab 
Deck  Replace 
Super&Deck  Rehab 
Sup  RH  Deck  Repl 
Substruct  Rehab 
Sub&Deck  Rehab 
Sub  RH  Deck  Repl 
Sub,Sup&Deck  RH 
Sub  RH  Sup  Repl 
Sub& Sup  Rehab 
Sub&Sup  RH,Dk  RP 
Super  Replace 
Widen&Deck  Rehab 
Widen&Deck  Repl 
Raise /Lower  Pvmt 
Replace 


2 
2 

1 
1 
1 
1 
1 
1 
1 
2 
1 
1 
1 
1 
1 
1 
1 


Quitting  dtree.  Successful  completion. 

****done**** 

Press  Enter  to  exit. . . 

[A:\BRIDGE\PROG] 


Figure  8.6  Running  DTREE 
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Table   8.3    Description  of   Dtree.txt   Condition  Report 


Heading 

Description 

Bridge  num  and  des 

Bridge  number  and  designation 

Route  # 

Route  number 

Ois 

District  code 

Co .  Code 

County  code 

Act  Year 

Action  year 

Act  Code 

Action  code 

Action 

Action 

1992  Cost  ($1000) 

Base  year  cost  converted  to  analysis  year 
dollars 

Work  Code 

Work  code  from  NBIS  Recording  and  Coding  Guide 

Work  Proposed 

Work  proposed  by  field  inspector 

Ex?  (T  or  F) 

T:  Exception  record  used 

F:  Exception  record  not  used 

Super  Cond. 

Superstructure  condition  number  in  analysis  year 

Sub  Cond. 

Substructure  condition  number  in  analysis  year 

Deck  Cond. 

Deck  condition  number  in  analysis  year 

In  Yr 

Inspection  year 

SuperQInYr, 
Sub@lnYr,  and 

Deck@lnYr 

Condition  numbers  in  inspection  year 

Action  Code 
Abbreviation1 

Rehab,  RH 

Rehabilitation 

Replace,  Repl,  RP 

Replacement 

Sup,  Super 

Superstructure 

Sub,  Substruct 

Substructure 

Pvmt 

Pavement 

Dk 

Deck 

1   See  Appendix  H   for  more   information. 
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INDOT  BMS 


DECISION  TREE  LOG 


Runfile:  test. run  YEAR  OF  ANALYSIS:  1992 


.processing  bridge  file  records 


Errors  in  bridge  record  02037 

HuyType   nonfatal 

ADT      fatal 

NumLanes  nonfatal 
Errors  in  bridge  record  05289A 

ADT      fatal 
Errors  in  bridge  record  07558 

DkUidth   fatal 

CIDkUid   fatal 

DeckCond  fatal 


SupCond 

fatal 

SubCond 

fatal 

DeckGeom 

fatal 

E 

mors  in  bridge  record  07710SBL 

HuyType 

nonfatal 

ADT 

fatal 

NumLanes 

nonfatal 

1  fatal  and  2  nonfatal. 


1  fatal  and  0  nonfatal. 


6  fatal  and  0  nonfatal. 


1  fatal  and  2  nonfatal. 


Total  Records  Successfully  Processed  10 
Total  Errors  In  Processing  Records  0 
Decision        Count 


Nothing 
Deck  Rehab 
Deck  Replace 
Super&Deck  Rehab 
Sup  RH  Deck  Repl 
Subs t rue t  Rehab 
Sub&Deck  Rehab 
Sub  RH  Deck  Repl 
Sub.Sup&Deck  RH 
Sub  RH  Sup  Repl 
Sub&Sup  Rehab 
Sub&Sup  RH.Dk  RP 
Super  Replace 
Uiden&Deck  Rehab 
Uiden&Deck  Repl 
Raise/Lower  Pvmt 
Replace 


Figure  8.8  Dtree.log 


1   5   10   15   20 

25 

30 

35 

40   4 

00652    199416345 

0 

0.0 

0 

0  0 

00899B   199410547 

0 

0.0 

0 

0  0 

01083A   199413555 

0 

0.0 

0 

0  0 

01083A   199514554 

0 

0.0 

0 

0  0 

01363A   1994  1755 

0 

0.0 

0 

0  0 

01 363 A   1995  2754 

0 

0,0 

0 

0  0 

01363A   1996  7744 

0 

0.0 

0 

0  0 

02431    1994  4574 

0 

0.0 

0 

0  0 

02456AUBL1994  3456 

0 

0.0 

0 

0  0 

02456AUBL1995  8445 

0 

0.0 

0 

0  0 

02456AUBL1997  9334 

0 

0.0 

0 

0  0 

Figure  8.9  Dtree.out  twenty  projects  were  selected. 
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03451    199411443 

0 

0.0 

0  0  0 

03451    1995  9343 

0 

0.0 

0  0  0 

04216BSBL1994  0567 

0 

0.0 

0  0  0 

04540CSBL199415555 

0 

0.0 

0  0  0 

04540CSBL199612444 

0 

0.0 

0  0  0 

04858AUBL1994  0666 

0 

0.0 

0  0  0 

04858AUBL1996  1655 

0 

0.0 

0  0  0 

04858AUBL1997  6645 

0 

0.0 

0  0  0 

06934    1994  5747 

0 

0.0 

0  0  0 
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Figure  8.9,  continued 


110 
recommends  repairs  for  each  bridge.  To  examine  these  reports, 
use  the  IBMS  Tool,  "View  Reports." 

Although  only  fifteen  bridges  appear  in  the  database 
file,  Since  DTREE  analyzes  a  set  of  bridges  over  a  four-year 
period,  multiple  projects  may  be  recommended  for  each  bridge. 
After  projects  are  selected,  repair  costs  are  computed,  in 
analysis  year  dollars.  The  text  report  (Figure  8.7)  also 
provides  the  work  proposed  by  the  field  inspector,  which  can 
be  compared  to  the  project  recommended  by  DTREE.  The 
"condition"  report  lists  condition  numbers  for  the  inspection 
year,  as  well  as  for  the  analysis  year. 

The  log  file  (Figure  8.8)  produces  a  record  of  program 
execution,  noting  any  errors  that  may  occur.  Fatal  errors 
were  found  in  four  bridges,  indicating  that  they  contained  bad 
or  missing  data.  Consequently,  these  four  bridges  cannot  be 
processed  by  any  of  the  programs  until  the  errors  are 
corrected. 

The  output  file  (Figure  8.9)  provides  information  needed 
by  COST.  Although  the  information  in  the  Lotus  12  3  report 
(Figure  8.10)  appears  to  be  out  of  alignment,  when  it  is 
imported  into  a  spreadsheet  program,  each  column  will  be 
properly  aligned. 


Ill 

8.4  COST 

The  procedure  for  running  COST  is  shown  in  Figure  8.11. 
The  corresponding  output  files  are  provided  in  Figures  8.12 
through  8.15.  At  this  stage,  the  user  can  select  projects 
only  on  the  basis  of  cost  effectiveness. 

The  cost  report  (Figure  8.12  and  Tables  8.5  and  8.6) 
takes  the  projects  selected 
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Table  8.4  Dtree.out  Format 


Position 

Description 

1-5 

bridge  number  in  the  bridge  database  file 

6-9 

bridge  designation  in  the  bridge  file 

10-13 

action  year  generated  by  DTREE 

14-15 

action  code  generated  by  DTREE 

16 

superstructure  condition  at  time  of  action 

17 

substructure  condition  at  time  of  action 

18 

deck  condition  at  time  of  action 

19-24 

exception  bridge  length  from  the  exception  file 

25-29 

exception  bridge  width  from  the  exception  file 

30-35 

exception  approach  length 

36-37 

exception  vertical  clearance  (ft) 

38-39 

exception  vertical  clearance  (in) 

Note  that  the  program  dtree.for  first  initializes  columns 
19  through  39  (exception  file  information)  with  values  of 
zero.  If  exceptions  are  used,  the  program  will  then  replace 
the  zeroes  with  exception  information  in  the  output  file.  The 
output  file  shown  in  Figure  8.9  did  not  have  any  exception 
information;  conseguently,  several  columns  of  zeroes  appear  in 
the  file. 
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Table  8.5  Description  of  COST  Look  Ahead  Report 


Heading 

Description 

Bridge  num  and  des 

Bridge  number  and  designation 

Route  # 

Route  number 

Dis 

District  code 

Co.  Code 

County  code 

Act  Year 

Action  year 

Act  Code 

Action  code 

Action 

Action 

1992  Cost  ($1000) 

Base  year  cost  converted  to  analysis  year 
dollars,  in  thousands 

EUAC  $1000 

Equivalent  uniform  annual  cost,  in  analysis 
year  dollars 

CEF  v/$/1000f2 

Cost  effectiveness  factor,  in 
vehicles/ $1000/ feet2 

Ex?  (T  or  F) 

T:  Exception  record  used 

F:  Exception  record  not  used 

Year 

Year  of  next  repair  in  life  cycle 

Ac 

Repair  code 

Yr  1992  Cost  ($1000) 

Estimated  cost,  in  analysis  year  dollars 
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RUNFILE:  runfile.run 


COST 


PROGRAM 


LOG 


YEAR  OF  ANALYSIS:  1992 


Processing  input  records... 


=====  Summary  ==== 
Records  Processed:    18 
Total  Errors     :     0 


Total  Cost  ($1000)  6339.3 

Total  EUAC  ($1000)  711.7 

Total  CEF  ($1000)  375.8 

AVE   Cost  ($1000)  352.2 

AVE   EUAC  ($1000)  39.5 

AVE   CEF  ($1000)  20.9 


Figure  8.13  Cost. log 
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00652    199416345 

0 

0.0 

0 

0 

0 

194.5 

19.6 

24.187FF1994 

4596  36.9 

00899B   199410547 

0 

0.0 

0 

0 

0 

49.3 

7.7119.076FF2024 

4284  44.8 

01083A   199413555 

0 

0.0 

0 

0 

0 

174.9 

23.6 

3.948FF2024 

1466  28.0 

01083A   199514554 

0 

0.0 

0 

0 

0 

233.2 

25.5 

3.644FF2025 

1510  28.0 

01363A   1994  1755 

0 

0.0 

0 

0 

0 

95.7 

15.2 

7.422FF2024 

1641  34.3 

01363A   1995  2754 

0 

0.0 

0 

0 

0 

266.0 

24.9 

4.528FF2025 

1691  34.3 

01363A   1996  7744 

0 

0.0 

0 

0 

0 

266.0 

23.0 

4.889FF2026 

1743  34.3 

02431    1994  4574 

0 

0.0 

0 

0 

0 

2778.1 

291.6 

2.174FF2039104333157.5 

02456AUBL1994  3456 

0 

0.0 

0 

0 

0 

145.3 

26.0 

6.677FF2039 

3720  40.7 

02456AUBL1995  8445 

0 

0.0 

0 

0 

0 

173.0 

25.9 

6.719FF2040 

3833  40.7 
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0 
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0 
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4071  40.7 
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15.8 

25.528FF2009 
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14.9 

26.939FF2010 

2905  28.0 

04540CSBL199415555 
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0 

350.0 

47.0 

10.029FF2039 

13379  41.3 

04540CSBL 19961 2444 

0 

0.0 

0 

0 

0 

324.1 

38.8 

12.150FF2041 

14206  41.3 

04858AWBL1996  1655 

0 

0.0 

0 

0 

0 

128.3 

15.0 

38.981FF2026 

7892  38.0 

04858AUBL1997  6645 

0 

0.0 

0 

0 

0 

128.3 

13.9 

42.084FF2027 

8133  38.0 

06934    1994  5747 

0 

0.0 
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0 

0 

25.0 

10.2 

10.137FF2024 

1532  43.5 

Figure  8.14  Cost. out 
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Table  8.6  Cost. out  Format 


Position 

Description 

1-5 

bridge  number  from  the  bridge  database  file 

6-9 

bridge  designation 

10-13 

year  of  action 

14-15 

action  code 

16 

superstructure  condition  at  time  of  action 

17 

substructure  condition  at  time  of  action 

18 

deck  condition  at  time  of  action 

19-24 

exception  bridge  length  passed  from  DTREE  via 
COST 

25-29 

exception  bridge  width 

30-35 

exception  approach  length 

36-37 

exception  vertical  clearance  (ft) 

38-39 

exception  vertical  clearance  (in) 

40-46 

cost  of  project  in  base  year  dollars 

47-53 

EUAC  in  base  year  dollars,  assuming  project 
specified  is  done  in  the  action  year 

54-60 

CEF  in  base  year  dollars 

61 

flag  set  to  TRUE  if  any  exception  information 
was  used  by  the  COST  program 

62 

flag  set  to  FALSE  if  action  estimated  by  DTREE 
o  NOTE:  program  has  been  changed  so  that  flag 
will  always  be  false 

63-66 

year  bridge  will  be  replaced  based  on  the 
action  recommended  and  the  life  cycle  model 

67-72 

estimated  ADT  at  the  year  of  action  specified 

73-77 

clear  deck  width  after  action  specified  above 
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by  DTREE  and  calculates  the  life  cycle  costs  (EUAC)  and  cost 
effectiveness  factor  (CEF)  for  each  bridge.  The  "look  ahead" 
text  report  provides  repair  costs,  in  analysis  year  dollars,  for 
projects  anticipated  in  the  future.  If  no  action  is  recommended 
by  DTREE  (bridges  04858AWBL  and  04216BSBL,  for  example) ,  a  life 
cycle  cost  analysis  will  not  be  performed.  In  addition,  these 
records  will  not  be  used  by  subsequent  programs. 


8.5  RANK 

The  procedure  for  running  RANK  is  shown  in  Figure  8.16. 
The  corresponding  output  files  are  provided  in  Figures  8 .  17 
through  8.20.  See  Tables  8.7,  8.8  for  the  format  of  RANK  output 
files.  At  this  point,  projects  can  be  selected  on  the  basis  of 
their  disutility;  as  the  disutility  increases,  the  urgency  for 
repair  increases. 

The  disutilities  are  computed  individually  for  each  utility 
function,  and  then  weighted  and  added  together  to  yield  the 
overall  disutility.  The  "utility"  report  (Figure  8.17)  lists 
the  individual  disutilities  before  a  repair  is  made. 


8.6  OPT 
The  procedure  for  running  OPT  is  shown  in  Figure  8.21.  The 
corresponding  output  files  are  provided  in  Figures  8.22  through 
8.24.   By  running  OPT,  projects  are  optimized  one  year  at  a  time 
over  a  four-year  period.   The  report  (Figures  8.22-8.24) 
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Table  8.7  Description  of  Rank.txt  Utility  Report 


Heading 

Description 

Bridge  num  and  des 

Bridge  number  and  designation 

Route  # 

Route  number 

Ds 

District  code 

Co.  Code 

County  code 

Act  Year 

Action  year 

Act  Code 

Action  code 

Action 

Action 

Cost  ($1000) 

Base  year  cost  converted  to  analysis  year 
dollars,  in  thousands 

EUAC  $1000 

Equivalent  uniform  annual  cost,  in  analysis 
year  dollars 

Ex?  (T  or  F) 

T:  Exception  record  used 

F:  Exception  record  not  used 

Util  Now 

Total  disutility  of  bridge  before  repair,  for 
action  year 

Util  Aftr 

Total  disutility  after  repair,  for  action 
year 

Dlta  Util 

Change  in  total  disutility  before  and  after 
repair,  for  action  year 

Cost  Eff.1 

Cost  effectiveness  disutility  function  value 

Rem.  Life1 

Remaining  life  disutility  function  value 

Strc  Cond1 

Structural  condition  disutility  function 
value 

Clr.  Deck' 

Clear  deck  width  disutility  function  value 

Vert  Clr.1 

Vertical  clearance  disutility  function  value 

Inv  Rtng1 

Inventory  rating  disutility  function  value 

Det.  Len.1 

Detour  length  disutility  function  value 

1  These  disutility  values  represent  the  disutility  before  a  repair  is  made. 
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Table  8.8  Rank. out  Format 


Position 

Description 

1-5 

bridge  number  in  the  bridge  database 

6-9 

bridge  designation 

10-13 

year  of  action. 

14-15 

action  code 

16 

superstructure  condition  at  the  year  of  action 

17 

substructure  condition  at  the  year  of  action 

18 

deck  condition  at  the  year  of  action 

19-24 

exception  bridge  length  passed  from  DTREE  via  COST 

25-29 

exception  clear  deck  width 

30-35 

exception  approach  length 

36-37 

exception  vertical  clearance  (ft) 

38-39 

exception  vertical  clearance  (in) 

40-46 

repair  cost  in  analysis  year  dollars  from  COST 

47-53 

base  EUAC  from  COST 

54-60 

base  CEF  from  COST 

61 

exception  used  flag  from  COST 

62 

if  TRUE,  repair  was  derived  from  the  life  cycle  instead 
of  DTREE.   RANK  will  not  process  any  records  set  to 
TRUE,  so  all  output  in  this  field  will  be  FALSE 

63-64 

disutility  of  project  if  done  in  year  of  action 

65-68 

year  of  replacement  from  COST 

69-74 

estimated  ADT  in  the  year  of  action 

75-76 

estimated  disutility  after  the  project  is  done  (if  done 
in  the  year  of  action) 

77-78 

change  in  disutility  after  project  completion 

79-80 

disutility  of  project  2  years  after  analysis  year 

81-82 

disutility  of  project  3  years  after  analysis  year 

83-84 

disutility  of  project  4  years  after  analysis  year 

85-86 

disutility  of  project  5  years  after  analysis  year 

87-88 

estimated  disutility  after  project  completion  if  done  2 
years  after  year  of  analysis 

89-90 

estimated  disutility  after  project  completion  if  done  3 
years  after  year  of  analysis 
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Table   8.8,    continued 


Position 

Description 

91-92 

estimated  disutility  after  project  completion 
years  after  year  of  analysis 

if  done  4 

93-94 

estimated  disutility  after  project  completion 
years  after  year  of  analysis 

if  done  5 

95-100 

estimated  ADT  2  years  after  year  of  analysis 

101-106 

estimated  ADT  3  years  after  year  of  analysis 

107-112 

estimated  ADT  4  years  after  year  of  analysis 

113-118 

estimated  ADT  5  years  after  year  of  analysis 
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[A:\BRIDGE\PROG] opt 

Input  analysis  year  (same  as  DTREE) :  1992 

•  •  • 

OPTIMIZATION  PROGRAM 

Enter  year  of  optimization 
1994 

Enter  the  estimated  budget  for  each  year  ($1000) 
YEAR         1994:   1000 

•  •  • 

OPTIMIZATION  PROGRAM 


Enter  year  of  optimization 
1995 

Enter  the  estimated  budget  for  each  year  ($1000) 
YEAR         1995:   1000 


OPTIMIZATION  PROGRAM 


Enter  year  of  optimization 
1996 

Enter  the  estimated  budget  for  each  year  ($1000) 
YEAR         1996:   1000 


OPTIMIZATION  PROGRAM 


Enter  year  of  optimization 
1997 

Enter  the  estimated  budget  for  each  year  ($1000) 
YEAR         1997:   1000 


Figure  8.21  Running  OPT 
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provides  a  year  by  year  listing  of  the  projects  selected  by 
OPT.  The  year  indicated  in  the  output  may  not  correspond  to 
the  year  of  optimization,  signifying  that  the  funding  for  a 
previous  year  was  not  adequate  and  the  project  was  carried 
over. 

The  o/p  of  the  optimization  program  is  a  year  by  year 
listing  of  the  selected  bridges  in  COST  o/p  format,  given  by 
CH0SEN_1.0UT,  CH0SEN_2.0UT,  CH0SEN_3 .OUT,  and  CH0SEN_4 . OUT. 
They  are  located  in  the  \bridge\reports  directory,  and  can  be 
viewed  as  described  in  Chapter  3.  These  files  are  listed  in 
Figures  8.22  through  8.24.  CH0SEN_4.0UT  is  not  present  since 
all  bridges  had  been  selected  before  the  fourth  year. 
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00652  199416345 
00899B  199410547 
01083A  199413555 
01363A  1994  1755 
02456AUBL1994  3456 
03451    199411443 


0 

0.0 

0  0  0 

194.5 

19.6  24.187FF1994 

4596  36.9 

0 

0.0 

0  0  0 

49.3 

7.7119.076FF2024 

4284  44.8 

0 

0.0 

0  0  0 

174.9 

23.6  3.948FF2024 

1466  28.0 

0 

0.0 

0  0  0 

95.7 

15.2  7.422FF2024 

1641  34.3 

0 

0.0 

0  0  0 

145.3 

26.0  6.677FF2039 

3720  40.7 

0 

0.0 

0  0  0 

140.3 

15.8  25.528FF2009 

2819  28.0 

Figure  8.22   chosen  l.out 


04540CSBL199415555 


0  0.0     0  0  0  350.0   47.0  10.029FF2039  13379  41.3 


Figure  8.23   chosen  2. out 


04858AUBL1996  1655 


0  0.0     0  0  0  128.3   15.0  38.981FF2026  7892  38.0 

Figure  8.24   chosen  3 . out 
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*  Refer  to  separate  flow  chart. 

(1)  Convert  Recording  and  Coding  Guide 
codes  to  codes  used  by  the  program.  For 
example,  assign  default  values  for  approach 
lengths.  See  Chapter  2  for  more  information. 

(2)  A  record  was  located  in  the  exception  file 
that  matches  the  bridge  number  and 
designation  of  a  record  in  the  bridge 
database  record. 
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Figure  A.l   DTREE:    Main  Proaram 
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(1)  Includes  dollar  conversion,  decision  tree! 
and  cost  files.  \ 


Open  Except. 

File  for 

Random 

Access 


Return 


Print 
Report 
Headers 


>jU «-■-■:*■.>. ;;w-;»—i  ;S:Ulii*iirtii^vH«.*vJi^*»! 


M 


Open  Output 
File 


:■:      |      -:'■■'■  ---^-.         -:■■*    "' 


Figure  A. 2  Initialize  DTREE 
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Check  Each 

Field  In  Bridge 

Rec 


Rag  as 
Non-Fatal 


Return  with 
Compiled 

Error 
Messages 


Flag  as 
Fatal 


Vmiasmimm 


Add  Error 

Message  to 

List 


:iT.^::.:,:..,^;i.-.;;iiL.:..ja.ii^:i^ 


(1)  Any  field  with  data  not 
conforming  to  the  Recording  and 
Coding  Guide. 

(2)  Bad  condition  numbers, 
missing  lengths  or  widths,  or  other 
missing  or  bad  data  which  prevent 
decision  tree  from  functioning. 


Figure  A. 3    Check  Record 


Search  Except. 
File  for  Rec  that 
Matches  Bridge 
#  in  Bridge  File 


Return  with  Error 

Code  -1 

(2) 


yes 


Return  Record  # 

and  Data 

(1) 


Return  0:  No 

Except.  Found 

(2) 


(1)  Includes  exception  action, 
year,  length,  width,  approach 
length  (feet),  and  vertical 
clearance  (feet  and  inches). 

(2)  If  code  is  <  =0,  then  the  main 
program  will  not  attempt  to 
process  exceptions  for  this 
bridge. 

See  Chapters  6  and  7  for  more  information 
about  exception  files. 


Figure   A. 4   Get   Exception 
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Replace 

Vertical 

Clearance  in 

Bridge 

Record 

(3) 


(1 )  The  "process  exceptions"  option  has  I 
been  set  to  yes  and  an  exception  has  been  I 
found  for  the  current  bridge  record. 

(2)  Vertical  clearance  units:  feet  and  inches.  | 

•  If  Vclear  <  =  0,  a  default  value  is  set  by  tht 
program. 

•  If  Vclear  >  0,  that  value  in  the  field  is  used 
as  the  vertical  clearance. 

(3)  For  more  information,  see  DTREE:  Main 
Program,  "Map  Record"  or  program  listings 
bdata.for  and  map.for. 


Figure  A. 5  Overlay  Vertical  Clearance 


HepacT 

Approach 

Length  in 

Bridge 

Record 

(3) 


(1)  The  "process  exceptions"  option  has  been 
to  yes  and  an  exception  has  been  found  for  th 
current  bridge  record. 

(2)  Approach  length  units:  feet. 

•  If  Applen  <  =  0,  a  default  value  is  set  by  the 
program. 

•  If  Applen  >  0,  that  value  in  the  field  is  used  : 
the  approach  length. 

(3)  For  more  information,  see  DTREE:  Main 
Program,  "Map  Record"  or  program  listings 
bdata.for  and  map.for. 


Figure  A. 6  Overlay  Approach  Length 
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\/ 


Look  at 

Decision  i 

(D 


(1)  Decisions  for  a  bridge  are  based  on 
projected  condition  numbers  2,  3,  4,  and  5 
years  from  the  year  of  analysis. 

(2)  The  same  decision  may  have  been  made 
for  one  or  all  sets  of  projected  condition 
numbers;  save  a  decision  code  only  when  it 
occurs  for  the  first  time. 

(3)  The  year,  projected  condition  numbers, 
and  repair  code  of  the  action  are  saved.  If 
the  decision  type  is  "nothing"  (no  action 
recommended),  the  year  is  set  2  years  from 
the  analysis  year  (now  +  2). 


Figure  A. 7  Select  Decisions 
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Write  .txt 

Report 

0) 


■a, 


igsr 


WUHNtt  *  ~  «-■  *  ■'  X&Hi  &* 


Write  .out 

Report 

(2) 


Write 

.prn 

Report 

(i)„  i; 


* 


(1)  Reports  include:  j 

Standard: 

•  Bridge  number  and  Designation 

•  Route  number  i 

•  District  and  County 

•  Repair  year 

•  Repair  code  and  description 

•  Repair  cost,  in  $1000's,  analysis  year 
dollars 

•  Recommended  action  from  Item  75  of  the 
Recording  and  Coding  Guide 

•  Exceptions  used  (True  or  False) 

Optional: 

•  Condition  numbers  at  time  of  repair 

•  Exception  file  information,  rf  any 

(2)  Output  file  contains  only  unique 
information  needed  by  subsequent  programs 
in  the  system: 

•  Bridge  number  and  designation 

•  Repair  year  and  code 

•  Condition  numbers  at  time  of  action 

•  Exception  length,  width,  approach  length, 
and  vertical  clearance,  if  applicable 


Figure  A. 8  Write  DTREE. Reports 
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Write 

Summary 

to.txt 

0) 


ii 


•aaMrtiii&MJI&Mii'    !-:*  .:*.rf*Ww  .JBW^ 


Write 

Summary 

to  .prn 

0) 


Write 

Summary  to 

Screen 

(1) 


(1)  Summary  information: 

•  Number  of  records  successfully 
processed 

•  Number  of  records  rejected  due 
to  errors 

•  Total  number  of  each  decision 
selected. 

Note  that  the  number  of  projects 
selected  does  not  necessarily  equal 
the  number  of  records  processed 
plus  the  number  rejected,  since 
more  than  one  decision  can  be 
recommended  for  each  bridge. 


Figure  A. 9  Write  DTREE  Summary 
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Write 
**done*** 
to  Screen, 
exitmssg 
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Exit 


Write 

to  Screen, 
exitmssg 
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Figure   A. 10    Quit   DTREE 


Appendix  B  COST  Flow  Charts 
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Calculate 

EUAC  and 
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Quit  COST 


*  Refer  to  separate  flow  chart. 

(1)  This  option  is  set  in  the  runfile. 

(2)  Convert  Recording  and  Coding  Guide 
codes  to  codes  used  by  the  program.  For 
example,  assign  default  values  for  approach 
lengths.  See  Chapter  2  for  more  information. 


Figure  B.l  COST:  Main  Program 
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Figure   B.2    Initialise   COST 
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Set  Action 

to  Nothing 

(4) 


Exit 


Find  End  of 

Bridge  Life 

Cycle 

(5) 


& 


Set  Variables 

to  do 

Calculations 

0) 

J 


Find  Rehab  in 

Cycle 
Expected  for 

Bridge 
(6) 


Set  Variables 

to  do 

Calculations 

0) 


nsf 


goto 
A 


(1)  Set  up  arguments  for  Cycle  to 
calculate  the  life  cycle  costs 
properly. 

(2)  The  action  code  passed  from 
DTREE  is  a  replacement. 


(3)  The  action  code  passed  from 
DTREE  is  a  rehabilitation;  many 
types  of  rehabilitation  exist,  but  all 
will  be  treated  in  a  similar  manner. 

(4)  The  action  code  passed  from 
DTREE  is  either  0  (do  nothing)  or  not 
recognized  as  a  replacement  or 
rehabilitation.   A  code  of  0  means 
that  DTREE  did  not  recommend  a 
repair,  indicating  that  the  bridge  is 

in  good  condition.  Therefore,  a  life 
cycle  cost  analysis  will  not  be 
performed. 


goto  | 

R         J 


1 


(5)  The  end  of  the  life  cycle  and  the  last 
repair  year  before  replacement  are 
found.  Initial  maintenance  costs  are 
calculated  from  the  analysis  year  to  the 
end  of  the  cycle,  with  any  yearly 
increases  based  on  the  time  interval 
between  the  last  repair  before 
replacement  and  the  analysis  year. 

(6)  The  rehabilitation  expected  for  a 
bridge  of  this  age  is  found,  assuming  that 
this  rehabilitation  is  suggested  by 
DTREE.  The  most  recent  rehabilitation  is 
also  located  in  the  life  cycle  model. 
Initial  maintenance  costs  are  computed 
from  the  analysis  year  to  the  time  of  the 
repair,  based  on  the  time  interval 
between  the  most  recent  rehabilitation 
and  the  analysis  year.  If  the  rehabilitation 
suggested  by  DTREE  is  the  first  one  in 
the  cycle,  then  the  starting  point  of  the 
life  cycle  is  used  as  the  reference  base 
for  maintenance  cost  calculations. 


Figure  B.3  Calculate  Full  Cycle 
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(1)  Maintenance  costs  start  at  al 
fixed  level  after  a  repair  is  mad  el 
Eventually,  these  costs  may 
begin  to  increase.  To  calculate 
the  maintenance  costs  betwee 


,1 


the  analysis  year  (now)  and  the 
next  repair  year,  the  most  recent 
repair  year  must  be  set  so  that 
any  maintenance  cost  increased 
can  be  accounted  for.  ' 


(2)  The  prior  cycle  includes         | 
maintenance  costs  from  "now" 
until  the  first  action,  continuing 
through  the  life  cycle  up  to  but 
not  including  the  next 
replacement.  Maintenance 
costs  are  calculated  for  the 
interval  between  repairs,  which 
occur  at  times  specified  by  the 
life  cycle  model.  Formore 
information,  see  the  Life  Cycle 
Parameter  File  or  bdata.for. 

(3)  The  code  (type)  of  the  first 
action  is  taken  from  the  ouput  of 
DTREE  when  non-zero.  The  life 
cycle  model  will  typically  consist 
of  general  repairs,  such  as 
bridge  replacement,  deck 
rehabilitation,  or  deck  replace. 
DTREE  may  specify  any  of  17 
actions,  so  the  code  from 
DTREE  is  used  for  the  first 
repair,  and  those  from  the  life 
cycle  model  for  later  repairs. 


(4)  The  profile  cycle  begins  with 
the  first  replacement  in  the 
model  after  the  initial  action.  If 
the  initial  action  is  a  replace, 
then  the  profile  cycle  wiil  begin 
one  full  bridge  lifespan  after  the 
replacement  occurs. 


Figure   B.3,    continued 
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8 


1)  Use  variables  set  by  Full  Cycle  to  call 
"ycle.  This  step  determines  repair  costs  and 
years,  and  data  needed  for  maintenance 
cost  computations  for  the  prior  cycle. 


(2)  Use  variables  set  by  Full  Cycle  to  call 
Cycle.  This  step  determines  repair  costs  and 
years,  and  data  needed  for  maintenance 
cost  computations  for  the  profile  cycle 
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*  Refer  to  separate  flow  chart.  i 

(1)  The  calling  routine  (Full  Cycle)  sets 
variables  passed  to  Cycle  so  that  it  begins  at 
a  certain  point  in  the  life  cycle  model  and     I 
computes  costs  for  all  maintenance  and       J 
repair  activities  from  that  point  to  the  end  of 
the  model. 

(2)  The  yearly  maintenance  cost,  in  base 
year  dollars  at  the  time  of  the  repair,  is 
computed  and  stored.  These  costs  start  out 
at  a  fixed  level  and  may  increase  in 
subsequent  years. 

(3)  Only  the  base  cost  of  the  repair  is  stored. 
The  year  is  also  saved  so  that  the  present 
worth  of  repairs  and  other  economic 
statistics  can  be  calculated. 


See  FHWA/IN/JHRP-89/1 1 ,  Volume  4 
and  Figure  5.3  for  more  information 
about  life  cycle  models. 


Figure   B.4    Cycle 
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(1)  These  costs  are  brought  back  to  the 
analysis  year. 

(2)  EUAC  =  equivalent  uniform  annual  cost, 
in$1000's 

(3)  CEF  =  cost  effectiveness  factor,  in 
veh/$1000/fT2 

See  Figure  B.3,  notes  2  and  4, 
for  more  information  about 
the  prior  and  profile  cycles. 


Figure  B.5  Calculate  EUAC  and  CEF 
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Return 


(1)  Reports  fnciude: 

Standard: 

•  Bridge  number  and  Designation 

•  Route  number 

•  District  and  County 

•  Repair  year 

•  Repair  code  and  description 

•  Repair  cost,  in  $1000's,  analysis  year 
dollars 

•  EUAC,  in$1000's 

•  CEF,  inveh/$1000/fT2 

•  Exceptions  used  (True  or  False)  ma 

•  Action  produced  by  life  cycle  model  (TrueB 
or  False)  ' 


P 

P 
P 


Optional: 

•  Next  4  repairs  in  life  cycle  ("look  ahead" 
option) 

•  Present  worth  of  repairs 


(2)  Output  file  contains  only  unique  9 

information  needed  by  subsequent  programs 
in  the  system: 


•  Bridge  number  and  designation 

•  Repair  year  and  code 

•  Condition  numbers  from  DTREE 

•  Exception  information  from  DTREE 

•  Repair  cost,  EUAC,  and  CEF  in  base  year 
dollars 

•  Flag  to  indicate  exceptions 

•  Year  of  bridge  replacement,  from  life  cycle 

•  Estimated  ADT 

•  New  clear  deck  width  after  repair 


P 


Figure  B.6  Write  COST  Reports 
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Write 

Summary 

to.txt 

(1) 


~« 


'& 


SS5S3S5B 


Write 

Summary 

to.prn 

0) 


& 


SiS 


Write 

Summary 

to  .log 

(D 


,v3 


■l- 


Write 

Summary  to 

Screen 

(1) 


QQSBESIBHB 


__-  : 


(1)  Summary  information: 

•  Number  of  records  successfully 
processed 

•  Number  of  errors 

•  Total  and  average  cost  of 
projects,  EUAC,  and  CEF 


Return 


"'U^^:h>r4:i'^J^W;|jW^q^'iit»ii;£!' 


Figure  B.7  Write  COST  Summary 
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Open  Exit 

Message  File 

(exitmssg) 


Write 

**done*** 

to  Screen, 

exitmssg 


Exit 


Write 

to  Screen, 
exitmssg 


*wS£wmISmu  s 


**•«!  WMA^huU'ri*  iw  iwii^l  hS  iW  i. 


Figure  B.8  Quit  COST 


Appendix  C  RANK  Flow  Charts 
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*  Refer  to  separate  flow  chart. 


Initialize 
Rank 


Get  Next 

Rec.  from 

Filtered  File 

(D 


Calculate 
Total  Utility 


Select  One 

Action  per 

Bridge 


Find  Matching 
Bridge  Record 


Get  ADT 
Statistics 


sssJ 


Map  Record 
(2) 


(1)  One  action  per  bridge  has  been  selectee 
and  written  to  a  work  file  called  "Filtered  File. 

(2)  Convert  Recording  and  Coding  Guide 
codes  to  codes  used  by  the  program.  For 
exampie,  assign  default  values  for  acprcacn 
lengths.  See  Chapter  2  for  more  information. 


<*" 

Write 
RANK 
Reports 

* 

■ 

a 

1 

| 

1 

*■ 

Write 
RANK 

Summary 

* 

:u 

3 

1 

1 
1 

1 

i. 
1 

I 

Quit  RANK 

« 

|    ■       1 

J 

1  ■    £ 

^                                                    J 

Figure  c.l  RANK:  Main  Program 
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Get  Year  and 
Runfile  Name 


Load  Def. 

Param.  Files 

0) 


■: | 


«-  :v^L:y;':^>M>-:::;i:i'j.n;i;-::^^ 


-.^v^**^^; 


Read  User 

Defined 

Runfile 


.      U;i-:;".  F.F.  -:;-hi:. ,-'—  "-■■*:■:, 


>P 


Load  Non- 

Def.  Param. 

Files  (1) 


^ 


'^^-....l:.;-   :■:    '■■:,-    \- ■' .,^^:^,:\^i^:^Z^ 


Open  .pm  File 


ititijJ-iiiJi-iiiCi:::;  l-ia.1:iiWrt:;i--«!J*iiW.L:fi" 


Open  Log  File 


(1)  Includes  ranking  weight  and  ranking 
utility  parameter  files. 


Return 


Print 
Report 
Headers 


vlr 


Open  Output 
File 


~~ '.    T    V~~~T^T~~i7^.-:  ■■ 


Figure  C.2  Initialize  RANK 
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Read  First 
Rank  Rec. 
into  Buffer 


^!^tttt*«^>il*UlUU£^*uiM^' 


Save  Record 

in  Buffer 

0) 


Read  Next 
Rank  Rec. 
into  Buffer 


w.'n ,  ..iitiiWiWJiWi^;  :- 


&a 


-AfcrtU*ij(fci*»*iii«ta«*w. 


Write 
Data  to 
Output 
File 


Exit 


Select  Key 

and  Put  in 

Storage  Buffer 

(3) 


goto 
A 


(1)  The  information  read  into  the  rank  input 
common  block  (input  buffer)  is  copied  into 
an  identical  block  (storage  buffer). 

(2)  The  bridge  number  and  designation  of 
the  record  in  the  input  file  are  the  same  as 
those  in  the  storage  buffer. 


(3)  Select  the  record  with  the  lowest  EUAC. 


.,  ..■■....,-,-  ■  .,.„... 


Figure  C.3  Select  One  Action  per  Bridge 


s 


Get  Rec. 

from 

Filtered  File 

(1) 


Convert 
Repair  Cost 
to  Analysis 
Year  Dollars 


Calculate 
ADTE  mean 


•a««iM«4b^  k:  I  -.■  m*j>m  eii  W£i»j&  nit 


Calculate 

ADTE 

Standard 

Deviation 

(4) 


I 
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(1)  This  file  has  only  one  selected  action  pet 
bridge. 


(2)  Average  Daily  Traffic  Effectiveness 
(ADTE)  is  calculated  by:  I 

ADTE  =  365  *  ADT/CEF 

where  CEF  =  cost  effectiveness  factor,  in  ] 
base  year  dollars  and  ADT  =  average  daily  | 
traffic 

(3)  n  =  number  of  records  successfully  read' 
from  the  filtered  input  file  (sample  size) 

(4)  Calculate  using  sum,  sum  of  squares,  anc 
sample  size. 


Set  ADTE 

mean  = 

Default  Value 


«b*WH«»iait™*-.   -~M*^W 


Set  ADTE 

Standard 

Deviation  = 

Default  Value 

(4) 


Add  to  Sum 

and  Sum  of 

Squares 


.  - „»«»•■' 


•■1  ■W^V..^.*..—-.*.-'-...^-/*,.  —t     "' 


Increment 

Count  of 

Usable 

Records 

(Sample  Size) 


Figure    C.4    Get   ADT   Statistics 
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■j  Write  .out 
Report 
(2) 


&, 


(1)  Reports  include: 

Standard: 

•  Bridge  number  and  Designation 

•  Route  number 

•  District  and  County 
t  Repair  year 

•  Repair  code  and  description 

•  Repair  cost,  in  SIOOO's.  analysis  year 
dollars 

•  EUAC,  SIOOO's 

•  Exceptions  used  (True  or  FaJse) 

•  Total  disutility  before  and  after  repair,  in 
action  year 

•  Change  in  disutility  before  and  after  repair 

Optional: 

•  Individual  disutilities 


(2)  Output  file  contains  only  unique 
information  needed  by  subsequent  programs 
in  the  system: 

•  Bridge  number  and  designation 

•  Repair  year  and  code 

•  Condition  numbers,  in  action  year 

•  Exception  information  from  DTREE 

•  Repair  cost  from  COST,  in  analysis  year 
dollars 

•  Base  EUAC  and  CEF  from  COST 

•  Exception  flag  from  COST 

•  Estimated  disutility  before  and  after  repair 
for  2,3,4,  and  5  years  from  analysis  year 

•  Estimated  ADT  2.3,4,  and  5  years  from 
analysis  year 


Figure  C.5  Write  RANK  Reports 
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Write 

Summary 

to.txt 

0) 


^ 


Write 

Summary 

to  .prn 

0) 


ii>Myfii!iwH'r«At. 


& 


Write 

Summary 

to  .log 

0) 


:S:I 


;:A':.^liW!w;i'i-ir:l!lM:ii^i;:r 


' '  --: 


I        ^ 


<4*:(!&W±i;igi:i£::    ■liii^i^a-iii.'iiiiitctvefetii.^ 


Write 
Summary  to 
Screen 
_     (1) 


^^a^if«^ife;*wi^3iij;iiii^iiSlfF 


Return 


W.^.i;^«.,.^:i*.T!H,li «H:',lJ*W»A'*ii 


(1)  Summary  information: 

•  Sample  size 

•  Number  of  actions  selected  and 
rejected 

•  Number  of  errors 

•  ADTE  mean  and  standard 
deviation 

Notes 

•  if  fatal  errors  occur,  default  values 
for  the  mean  and  standard  deviation 
are  used 

•  the  sum  of  the  number  of  records 
selected  and  rejected  should  equal 
the  sample  size 


Figure  C.6  Write  RANK  Summary 
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Close  All  Files 


^i.;-. —l^i*tiitjtii 


Open  Exit 

Message  File 

(exitmssg) 


:>;T"v  ? 


Write 

**done*** 

to  Screen, 

exitmssg 


Exit 


Write 

to  Screen, 
exitmssg 


-::;,;:.'■■:-   :«;,«,.:-;l|,,:;;:w::i 


Figure  C.7  Quit  RANK 


Appendix  D  Flow  Charts  For  Commonly  Used  Programs 
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Recalculate 

Bridge  Age 

(1) 


II "  Wt*««rii;»i.i  I  \m  {^MUH^tiliMtH^ 


Set  Condition 

State  Vectors 

(2) 


Select 

Markovian 

Matrix 

(3) 


7Z. 


Multiply  State 

Vector  by 

Matrix 

(4) 


"."".v.. i- 


Multiply  New 

State  Vector  by 

[9876543]t 

(5) 
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(1)  Determine  the  number  of  years  since  the 
last  repair  at  the  time  the  condition  numbers 
are  estimated. 

(2)  If  this  is  the  first  projection  year  (one  year 
after  inspection),  set  state  vector  to  unit 
vector:  [1000000).  However,  if  the  condition 
number  is  5,  the  initial  vector  will  be 
[0000100].  Similarly,  if  the  condition  number 
is  7,  the  initial  vector  is  [0010000].  Refer  to 
FHWA/IN/JHRP-89/13,  Volume  6,  Section 
2.5  for  more  information. 

(3)  Select  the  transition  matrix,  based  on  the 
bridge's  age  and  condition  at  this  point. 
Refer  to  the  tables  in  FHWA/IN/JHRP-89/13, 
Volume  6,  Figures  2.6-2. 1 7. 

(4)  v  =  v  *  [M],  where  v  is  the  state  vector 
and  M  is  the  matrix  selected  in  (3). 

(5)  Multiply  the  current  state  vector  by  the 
transpose  of  [9876543]  and  round  to  the 
nearest  integer.  This  vector  becomes  the 
new  condition  number. 


Figure  D.l  Degrade  Condition  Numbers 
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I 
I 


(1)  Backspace  in  bridge  database  file  tc 
the  point  where  the  program  first  startec 
looking.  On  the  next  call  to  this  routine. 
the  program  starts  looking  from  the 
same  point,  and  will  not  overlook  any 
matches. 


Exit  with 
"Miss"  Code 


1 

1 

1 

Exit  with 
"Miss"  Code 

1 

'*■ 

\ 

Figure  D.2  Find  Matching  Bridge  Record 
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Set  Bridge 
Len  =  Len  in 

Cost  Input 

File  (Except. 

Length) 


Exit,  with 

Length 

Unchanged 


(1)  See  extend.for  or  Recording  and  Cocing 
Guide,  Item  76,  for  function  used  to  extend 
length. 


Use  Extend 
Length  Fen  to 
Change  Bridge 

Length 

(1) 


Figure  D.3  Extend  Bridge  Length 


<Extenc 
Width 
Option 
Set 
yes 


Set  Bridge 

Width  = 

Width  in  Cost 

Input  File 

(Except. 

Width) 


Exit,  with 

Width 
Unchanged 


Use  Extend 
Width  Fen  to 

Change 

Bridge  Width 

0) 
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(1)  See  extend.for  for  more  information. 


Figure  D.4  Extend  Bridge  Width 


Appendix  E  OPT:  Program  Operation 
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The  programming  style  of  OPT  differs  from  that  of  the 
first  three  programs  (DTREE,  COST,  and  RANK) .  OPT  uses  the 
XMP  software  developed  by  Roy  A.  Marsten  to  optimize  year  by 
year  the  projects  to  be  selected.  For  a  description  of  the 
particular  program  used,  consult  "ZOOM  Users  Manual"  12/92. 
For  a  flow  chart  of  the  optimization  process,  including  the 
updating  of  bridge  information,  see  "The  Development  of 
Optimal  Strategies  for  Maintenance,  Rehabilitation  and 
Replacement  of  Highway  Bridges,  Final  Report  Vol.  6: 
Performance  Analysis  and  Optimization,"  by  Yi  Jiang  and  K.C. 
Sinha,  Report  No.  FHWA/IN/JHRP-89/13 ,  Joint  Highway  Research 
Project,  School  of  Civil  Engineering,  West  Lafayette,  Indiana. 
The  bridge  updating  is  accomplished  with  C  Language  UTILITIES 
SORT_COST_BY_YEAR.C,  MAKE_RANK_OUT . C ,  and  WRITE_0PT_BY2 . C. 


Appendix  F  File  Formats 
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F.l  Format  for  Bridge  Database  Records 
These  records  are  created  by  extracting  data  from  the 
main  bridge  inventory  database.  Each  record  is  composed  of 
ASCII  characters  and  is  terminated  by  a  new  line.  The  bridge 
records  are  read  by  the  Fortran  function  GetNextBridge  in  the 
program  GETBRIDG.FOR.  Refer  to  Chapter  7  for  information  on 
printing  the  bridge  database  file. 


162 


Table  F.l  Bridge  Database  Format 


Record  Layout 


POS.  =  the  position  of  the  field  in  the  record 
ITEM  =  the  Recording  and  Coding  Guide  item  number 
FORMAT  =  the  Fortran  format  used  to  read  the  field 


POS.    ITEM     FORMAT     DESCRIPTION 

1-4    5d      a4        highway  route  number 
5-7    3       i3        county  code 


The  next  2  fields  define  the  unique  bridge  key  (9 
characters) 


bridge  number 
bridge  designation 

highway  dept.  district  code 

year  of  original  construction 

last  year  bridge  was  repaired 

functional  class  code 

hwy  system  of  inventory  route 

average  daily  traffic  (ADT) 

number  of  traffic  lanes 

total  deck  width  (ft) 

clear  deck  width  (ft) 

bridge  length  (ft) 

vertical  clearance  (ft) 

vertical  clearance  (in) 

superstructure  material 

superstructure  construction 

detour  length  (mi) 

type  of  load 

inventory  rating  (tons) 

main  deck  surface  condition  rating 

superstructure  condition  rating 

substructure  condition  rating 

deck  geometry  code 

proposed  work  code 

date  of  last  inspection  (yr/month) 


8-12 



a5 

13-16 



a4 

17-18 

2 

i2 

19-22 

27 

i4 

23-26 

106 

i4 

27-28 

26 

i2 

29 

104 

il 

30-35 

29 

i6 

36-37 

28a 

i2 

38-41 

52 

f4.1 

42-45 

51 

f4.1 

46-51 

49 

i6 

52-53 

54 

i2 

54-55 

54 

i2 

56 

43a 

il 

57-58 

43b 

i2 

59-60 

19 

i2 

61 

66a 

il 

62-63 

66b 

i2 

64 

58 

il 

65 

59 

il 

66 

60 

il 

67 

68 

il 

68-69 

75 

i2 

70-73 

90 

i4 
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1   5   10   15   20   25   30   35   40   45   50   55   60   65   70 
+ + + + + + + + + + + + + +  — 

000703900652  05 1 9281 961 062004200020389036900007800001 0205 1 2354453 1 91 08 
002405600899B  041929199106200380002048704480000300000102061298658  9004 
005607801 083A  051947198506200130002034302800001620000102081316665  9008 
022708901363A  031938197307400150002037403430001262108602021325756359108 
003307102037  0419360000  00018001600001321402303007006766358912 
106504902431  031974000011108980008160515750002922204402021295577358912 
002405202456AWBL0219751991 1420034000204370407000156220740201 1257667  9109 
033105003451  041947000007400250002031302800000720000201062365666319002 
I06501004216BSBL051958198901 10132450204260395000124141010201 1328775  9005 
I 06900204540CSBL021961 198801 10126000304760413000210140440201 1296667349204 
002405204858AUBL021963198602200700002041003800001 020000201 01 1216666  9201 
I46500605289A  0319711982011  02029202620002121502202042327775  9109 
025202406934  051988000007400140002046504350001010000201092368867  9104 
001803807558  02198600000620017000200000000000030000031904236NNNH  9202 
00270890771 OSBL  0319760000        00009900670000841903502008007778  9104 


Figure  F.l  Bridge  Database  File 


F.2  Format  of  DTREE  Output  Records 
These  records  contain  unique  information  generated  by 
DTREE  that  is  passed  to  subsequent  programs  in  the  IBMS. 
Since  DTREE  is  the  only  program  in  the  system  that  reads 
exception  files,  this  information  is  passed  to  other 
programs  via  an  output  file  with  the  extension  .out.   Other 
information  not  passed  in  the  output  file  can  be  viewed  by 
printing  out  the  bridge  database  file;  refer  to  Chapter  7 
for  more  information. 

These  records  are  written  by  the  subroutine 
WriteDtreeReports  in  the  file  dtree.for  and  are  read  by  the 
COST  program  by  the  function  GetNextCostlnput  in  the  file 
COST. FOR. 
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Table  F.2  DTREE  Output  File  Format 


Record  Layout 


POS.  =  the  position  of  the  field  in  the  record 
FORMAT  =  the  FORTRAN  format  used  to  read  the  record 


POS. 

1-5 

6-9 

10-13 

14-15 

16 

17 

18 

19-24 

25-29 

30-35 

36-37 

38-39 


FORMAT 

a5 
a4 
i4 
i2 

il 

il 

il 

i6 

f5.1 

i6 

12 

12 


DESCRIPTION 

bridge  number  in  the  bridge  database  file 

bridge  designation  in  the  bridge  file 

action  year  generated  by  DTREE 

action  code  generated  by  DTREE 

superstructure  condition  at  time  of  action 

substructure  condition  at  time  of  action 

deck  condition  at  time  of  action 

exception  bridge  length  from  the  exception  file 

exception  bridge  width  from  the  exception  file 

exception  approach  length 

exception  vertical  clearance  (ft) 

exception  vertical  clearance  (in) 


1    5 
1 — 

00652 

00899B 

01083A 

01083A 

01363A 

01363A 

01363A 

02431 


10    15    20 

— + + +- 

199416345 
199410547 
199413555 
199514554 

1994  1755 

1995  2754 

1996  7744 
1994  4574 


25 


30 

+. 

0.0 


35 

— +■ 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 


40 


45 
— + 


02456AWBL1994  3456 
02456AWBL1995  8445 
02456AWBL1997  9334 
03451  199411443 
03451  1995  9343 
04216BSBL1994  0567 
04540CSBL199415555 
04540CSBL199612444 
04858AWBL1994  0666 
04858AWBL1996  1655 
04858AWBL1997  6645 
06934     1994  5747 


0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 
0 


0.0 
0.0 
0.0 
0.0 
0.0 


0. 
0. 
0. 
0. 
0. 
0, 


0.0 
0.0 
0.0 
0.0 
0.0 


Figure  F.2  DTREE  Output  File 
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F.3  Format  for  Exception  Records 
Exception  records  and  their  use  are  described  in  detail 
in  Chapter  6.  Exception  records  are  located  by  the  function 
GetException  in  the  program  getex.for.  Records  are  then 
read  sequentially  by  the  function  GetNextException,  which  is 
also  in  GETEX.FOR. 

Table  F.3  Exception  File  Format 

Record  Layout 

POS.  =  the  position  of  the  field  in  the  record 
FORMAT  =  the  FORTRAN  format  used  to  read  the  record 

DESCRIPTION 


POS. 

FORMAT 

1-5 

a5 

6-9 

a4 

10-11 

i2 

12-15 

i4 

16-21 

i6 

22-26 

f5.1 

27-32 

i5 

33-34 

i3 

35-36 

i2 

bridge  number 

bridge  designation 

code  for  action 

year  of  action 

new  bridge  length  after  next  action 

new  bridge  width  after  next  action 

approach  length  to  be  used 

vert  clear  (ft)  after  next  action 

vert  clear  (in)  after  next  action 
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1    5    10 

15 

20 

25 

30 

35 

40 

02052CSBL  5 

0 

0 

0.0 

0 

0  0 

02307ASBL-1 

0 

0 

0.0 

-1 

0  0 

02431     -12000 

0 

0.0 

0 

0  0 

026   A    16 

0 

0 

0.0 

0 

0  0 

04  3  31AWBL13 

0 

0555.0 

0 

0  0 

04426AWBL13 

0 

0 

-1.0 

0 

0  0 

04461A    16 

0 

555 

0.0 

0 

0  0 

0452A     -1 

0 

0555.0 

0 

0  0 

04603     -1 

0 

0 

-1.0 

0 

0  0 

04727A    -1 

0 

0 

0.0 

0 

0  5 

04734ANBL-1 

0 

0 

0.0 

0 

0-1 

04751ANBL-1 

0 

0 

0.0 

555 

0  0 

04770A    -1 

0 

0 

0.0 

055  0 

04780     -1 

0 

0 

0.0 

0- 

-1  0 

04813B    -1 

0 

0 

0.0 

0 

0  0 

05180BWBL-1 

-1 

-1 

-1.0 

-1- 

-1-1 

05181BWBL13 

0 

0 

0.0 

0 

0  0 

05271A    16 

0 

-1 

0.0 

0 

0  0 

05484     -1 

0 

555 

0.0 

0 

0  0 

05487ASBL-1 

0 

-1 

0.0 

0 

0  0 

Figure  F.3  Exception  File 


F.4  Format  for  COST  Output  Records 
These  records  contain  unique  information  generated  by 

COST,  as  well  as  information  passed  from  DTREE,  that  is  used 

in  subsequent  programs  in  the  system. 

These  records  are  written  by  the  subroutine 

WriteCostReports  in  the  program  COST. FOR;  they  are  read  by 

the  RANK  program  using  the  function  GetNextRanklnput  in  the 

program  RANK. FOR. 


167 

Table  F.4  COST  Output  File  Format 

Record  Layout 

POS.  =  the  position  of  the  field  in  the  record 
FORMAT  =  the  FORTRAN  format  used  to  read  the  record 

DESCRIPTION 


POS. 

FORMAT 

1-5 

a5 

6-9 

a4 

10-13 

i4 

14-15 

i2 

16 

il 

17 

il 

18 

il 

19-24 

i6 

25-29 

f5.1 

30-35 

i6 

36-37 

i2 

38-39 

i2 

40-46 

f7.1 

47-53 

f7.1 

54-60 

f7.3 

61 

LI 

bridge  number  from  the  bridge  database 

file 

bridge  designation 

year  of  action 

action  code 

superstructure  condition  at  time  of 

action 

substructure  condition  at  time  of  action 

deck  condition  at  time  of  action 

exception  bridge  length  passed  from 

DTREE  via  COST         i 

exception  bridge  width 

exception  approach  length 

exception  vertical  clearance  (ft) 

exception  vertical  clearance  (in) 

cost  of  project  in  base  year  dollars 

EUAC  in  base  year  dollars,  assuming 

project  specified  is  done  in  the  action 

year 

CEF  in  base  year  dollars 

flag  set  to  TRUE  if  any  exception 

information  was  used  by  the  COST  program 
62        LI        flag  set  to  TRUE  if  the  action  specified 

above  was  generated  from  the  life  cycle 

model  instead  of  DTREE 
63-66     i4        year  bridge  will  be  replaced  based  on 

the  action  recommended  and  the  life 

cycle  model 
67-72      i6        estimated  ADT  at  the  year  of  action 

specified 
73-77     f5.1      clear  deck  width  after  action  specified 

above 
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1   5   10   15   20 

25 

30 

35 

40 

45 

50   55   60   65 

70   75   8 

00652    199416345 

0 

0.0 

0 

0 

0 

194.5 

19.6 

24.187FF1994 

4596  36.9 

008998   199410547 

0 

0.0 

0 

0 

0 

49.3 

7.7119.076FF2024 

4284  44.8 

01083A   199413555 

0 

0.0 

0 

0 

0 

174.9 

23.6 

3.948FF2024 

1466  28.0 

01083A   199514554 

0 

0.0 

0 

0 

0 

233.2 

25.5 

3.644FF2025 

1510  28.0 

01363A   1994  1755 

0 

0.0 

0 

0 

0 

95.7 

15.2 

7.422FF2024 

1641  34.3 

01363A   1995  2754 

0 

0.0 

0 

0 

0 

266.0 

24.9 

4.528FF2025 

1691  34.3 

01363A   1996  7744 

0 

0.0 

0 

0 

0 

266.0 

23.0 

4.889FF2026 

1743  34.3 

02431    1994  4574 

0 

0.0 

0 

0 

0 

2778.1 

291.6 

2.174FF2039104333157.5 

02456AWBL1994  3456 

0 

0.0 

0 

0 

0 

145.3 

26.0 

6.677FF2039 

3720  40.7 

02456AUBL1995  8445 

0 

0.0 

0 

0 

0 

173.0 

25.9 

6.719FF2040 

3833  40.7 

02456AUBL1997  9334 

0 

0.0 

0 

0 

0 

361.2 

32.4 

5.358FF2042 

4071  40.7 

03451    199411443 

0 

0.0 

0 

0 

0 

140.3 

15.8 

25.528FF2009 

2819  28.0 

03451    1995  9343 

0 

0.0 

0 

0 

0 

145.6 

14.9 

26.939FF2010 

2905  28.0 

04540CSBL199415555 

0 

0.0 

0 

0 

0 

350.0 

47.0 

10.029FF2039 

13379  41.3 

04540CSBL 19961 2444 

0 

0.0 

0 

0 

0 

324.1 

38.8 

12.150FF2041 

14206  41.3 

04858AUBL1996  1655 

0 

0.0 

0 

0 

0 

128.3 

15.0 

38.981FF2026 

7892  38.0 

04858AWBL1997  6645 

0 

0.0 

0 

0 

0 

128.3 

13.9 

42.084FF2027 

8133  38.0 

06934    1994  5747 

0 

0.0 

0 

0 

0 

25.0 

10.2 

10.137FF2024 

1532  43.5 

Figure  F.4  COST  Output  File 


F.5  Format  for  Rank  Output  Records 
These  records  contain  information  on  project  ranking. 
RANK  calculates  the  disutility  of  the  project  before  and 
after  repairs  are  completed.   RANK  will  calculate  the  before 
and  after  disutilities  at  the  recommended  year,  as  well  as 
2,  3,  4  and  5  years  after  the  year  of  analysis.   The  results 
are  stored  separately  and  then  passed  to  OPT.   RANK  output 
records  are  written  by  the  subroutine  WriteRankReports, 
found  in  the  program  RANK. FOR. 
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Table  F.5  RANK  Output  File  Format 
Record  Layout 

POS.  =  the  position  of  the  field  in  the  record 
FORMAT  =  the  FORTRAN  format  used  to  read  the  record 

DESCRIPTION 


POS. 

FORMAT 

1-5 

a5 

6-9 

a4 

10-13 

i4 

14-15 

i2 

16 

il 

17 

il 

18 

il 

19-24 

i6 

25-29 

f5.1 

30-35 

i6 

36-37 

i2 

38-39 

i2 

40-46 

f7.1 

47-53 

f7.1 

54-60 

f7.3 

61 

LI 

62 

LI 

bridge  number  in  the  bridge  database 
bridge  designation 
year  of  action 
action  code 

superstructure  condition  at  the  year  of 
action 

substructure  condition  at  the  year  of 
action 

deck  condition  at  the  year  of  action 
exception  bridge  length  passed  from 
DTREE  via  COST 
exception  clear  deck  width 
exception  approach  length 
exception  vertical  clearance  (ft) 
exception  vertical  clearance  (in) 
repair  cost  in  analysis  year  dollars 
from  COST 

base  EUAC  from  COST 
base  CEF  from  COST 
exception  used  flag  from  COST 
if  TRUE,  repair  was  derived  from  the 
life  cycle  instead  of  DTREE 
RANK  should  not  process  any  records  set 
to  TRUE,  so  all  output  in  this  field 
will  be  FALSE 
63-64     i2        disutility  of  project  if  done  in  year  of 

action 

year  of  replacement  from  COST 
estimated  ADT  in  the  year  of  action 
estimated  disutility  after  the  project 
is  done  (if  done  in  the  year  of  action) 
change  in  disutility  after  project 
completion 

disutility  of  project  2  years  after 
analysis  year 

disutility  of  project  3  years  after 
analysis  year 

disutility  of  project  4  years  after 
analysis  year 

disutility  of  project  5  years  after 
analysis  year 
estimated  disutility  after  project 


65-68 

i4 

69-74 

i6 

75-76 

i2 

77-78 

i2 

79-80 

i2 

81-82 

i2 

83-84 

i2 

85-86 

i2 

87-88 

i2 

170 
Table  F.5,  continued 

completion  if  done  2  years  after  year  of 

analysis 
89-90      i2        estimated  disutility  after  project 

completion  if  done  3  years  after  year  of 

analysis 
91-92     i2        estimated  disutility  after  project 

completion  if  done  4  years  after  year  of 

analysis 
93-94     i2        estimated  disutility  after  project 

completion  if  done  5  years  after  year  of 

analysis 
95-100    i6        estimated  ADT  2  years  after  year  of 

analysis 
101-106    i6        estimated  ADT  3  years  after  year  of 

analysis 
107-112    i6        estimated  ADT  4  years  after  year  of 

analysis 
113-118    i6        estimated  ADT  5  years  after  year  of 

analysis 
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Table  G.1  Description  of  Happed  Bridge  Report' 


Heading 

Description 

Route 

Route  number 

Co. 

County  code 

Br  #  des 

Bridge  number  and  designation 

Dis 

District  code 

YrBlt 

Year  bridge  was  constructed 

Fixed 

Year  of  last  repair 

FC 

Functional  classification 

Hwy 

Highway  system  of  the  inventory  route 

ADT 

Average  daily  traffic 

Lns 

Number  of  lanes 

DkUid 

Deck  width 

ClUd 

Clear  deck  width 

Length 

Length  of  bridge 

Vft 

Vertical  clearance,  ft 

Vin 

Vertical  clearance,  in 

SM 

Superstructure  material 

SC 

Superstructure  construction 

Det 

Detour  length 

IR 

Type  of  load 

Ton 

Inventory  rating 

DC 

Deck  condition 

SC 

Superstructure  condition 

sC 

Substructure  condition 

DG 

Deck  geometry  code 

UK 

Proposed  work  code 

IDate 

Last  inspection  date 

DeckT2 

Deck  type 

'  See  Chapter  2, 
2  This  field  is 


Section  6  for  more  information, 
not  used  in  the  current  IBHS. 
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RUNFUE:  test. run 


DECISION 


TREE 


REPORT 


YEAR  OF  ANALYSIS:  1992 


Bridge 

nun   des 


Route 

# 


Co.   Act 
Code  Year 


Act 
Code 


Action 


1992 

Cost   Uork 
($1000)  Code 


Work 
Proposed 


00652 

0007 

5 

39 

1994 

16 

Replace 

206.2 

31 

Replace  Substd    F 

00899B 

0024 

4 

56 

1994 

10 

Sub&Sup  Rehab 

52.3 

0 

01 083 A 

0056 

5 

78 

1994 

13 

Uiden&Deck  Rehab 

185.5 

0 

01083A 

0056 

5 

78 

1995 

14 

Uiden&Deck  Repl 

247.3 

0 

01363A 

0227 

3 

89 

1994 

1 

Deck  Rehab 

101.4 

35 

Rehab  Substd      F 

01363A 

0227 

3 

89 

1995 

2 

Deck  Replace 

282.1 

35 

Rehab  Substd      F 

01363A 

0227 

3 

89 

1996 

7 

Sub  RH  Deck  Repl 

282.1 

35 

Rehab  Substd      F 

02431 

1065 

3 

49 

1994 

4 

Sup  RH  Deck  Repl 

2945.6 

35 

Rehab  Substd      F 

02456AUBL 

0024 

2 

52 

1994 

3 

Super&Deck  Rehab 

154.1 

0 

02456AWBL 

0024 

2 

52 

1995 

8 

Sub.Sup&Deck  RH 

183.4 

0 

02456AUBL 

0024 

2 

52 

1997 

9 

Sub  RH  Sup  Repl 

383.0 

0 

03451 

0331 

4 

50 

1994 

11 

Sub&Sup  RH.Dk  RP 

148.7 

31 

Replace  Substd    F 

03451 

0331 

4 

50 

1995 

9 

Sub  RH  Sup  Repl 

154.4 

31 

Replace  Substd    F 

04540CSBL 

1069 

2 

2 

1994 

15 

Raise/Lower  Pvmt 

371.1 

34 

Widen  w/  Repair   F 

04540CSBL 

1069 

2 

2 

1996 

12 

Super  Replace 

343.6 

34 

Widen  w/  Repair   F 

04858AUBL 

0024 

2 

52 

1994 

0 

... 

0.0 

0 

04858AUBL 

0024 

2 

52 

1996 

1 

Deck  Rehab 

136.1 

0 

04858AUBL 

0024 

2 

52 

1997 

6 

Sub&Deck  Rehab 

136.1 

0 

06934 

0252 

5 

24 

1994 

5 

Substruct  Rehab 

26.5 

0 

Total  Records  Successfully  Processed  10 
Total  Errors  In  Processing  Records  0 
Decision         Count 


Nothing 
Deck  Rehab 
Deck  Replace 
Super&Deck  Rehab 
Sup  RH  Deck  Repl 
Substruct  Rehab 
Sub&Deck  Rehab 
Sub  RH  Deck  Repl 
Sub.Sup&Deck  RH 
Sub  RH  Sup  Repl 
Sub&Sup  Rehab 
Sub&Sup  RH.Dk  RP 
Super  Replace 
Uiden&Deck  Rehab 
Uiden&Deck  Repl 
Raise/Lower  Pvmt 
Replace 


Figure  G.2  DTREE:  Normal  Report 
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Table  G.2  Description  of  DTREE  Report 


Heading 

Description 

Bridge  num  and  des 

Bridge  number  and  designation 

Route  # 

Route  number 

Die 

District  code 

Co .  Code 

County  code 

Act  Year 

Action  year 

Act  Code 

Action  code 

Action 

Action 

1992  Cost  ($1000) 

Base  year  cost  converted  to  analysis  year 
dollars 

Work  Code 

Work  code  from  NBIS  Recording  and  Coding  Guide 

Work  Proposed 

Work  proposed  by  field  inspector 

Ex?  (T  or  F) 

T:  Exception  record  used 

F:  Exception  record  not  used 

Super  Cond.' 

Superstructure  condition  number  in  analysis  year 

Sub  Cond.1 

Substructure  condition  number  in  analysis  year 

Deck  Cond.1 

Deck  condition  number  in  analysis  year 

In  Yr1 

Inspection  year 

SuperQlnYr, 
Sub@InYr,  and 
DeckOlnYr1 

Condition  numbers  in  inspection  year 

New  Length  (ft)2 

Replaces  length  in  bridge  data  base  file 

New  Width  (ft)2 

Replaces  width  in  bridge  data  base  file 

New  Applen  (ft)2 

Replaces  default  approach  length 

Vclear  ft  and  in2 

Replaces  vertical  clearance  (feet  and  inches)  in 
bridge  data  base  file 

Ex  Ac2 

Replaces  any  action  specified  by  DTREE 

1  These  items  appear  only  if  a  condition  report  style  is  specified. 

2  These  items  appear  only  if  a  exception  report  style  is  specified.   In 
addition,  if  exceptions  are  not  used,  as  in  this  example,  these  columns 
will  be  filled  with  values  of  zero.   See  Appendix  F.2  for  more 
information. 
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Table   G.2,    continued 


Action  Code 
Abbreviation3 

Rehab,  RH 

Rehabilitation 

Replace,  Repl,  RP 

Replacement 

Sup,  Super 

Superstructure 

Sub,  Substruct 

Substructure 

Pvmt 

Pavement 

Dk 

Deck 

See  Appendix  H   for  more   information. 


RUNFILE:   test. run 


COST 


PROGRAM 


REPORT 


YEAR  OF  ANALYSIS:    1992 


Bridge        Route     i     Co.       Act       Act 
num      des        #        s     Code    Year     Code 


Action 


Yr  1992  CEF       E 

Cost         EUAC       v/$/     x 

($1000)  $1000     1000f2  ? 


25.64 
126.26 
4.19 
3. 
7. 
4. 
5, 
2. 
7. 


.86 
.87 
.80 
.18 
.30 
.08 


00652  0007  5  39  1994  16  Replace  0.0  20.8 

00899B  0024  4  56  1994  10  Sub&Sup  Rehab  0.0  8.2 

01083A  0056  5  78  1994  13  Uiden&Deck  Rehab  0.0  25.0 

01083A  0056  5  78  1995  14  Widen&Deck  Repl  0.0  27.1 

01363A  0227  3  89  1994  1  Deck  Rehab  0.0  16.1 

01363A  0227  3  89  1995  2  Deck  Replace  0.0  26.4 

01363A  0227  3  89  1996  7  Sub  RH  Deck  Repl  0.0  24.4 

02431  1065  3  49  1994  4  Sup  RH  Deck  Repl  0.0  309.2 

02456AUBL  0024  2  52  1994  3  Super&Deck  Rehab  0.0  27.6 

02456AWBL  0024  2  52  1995  8  Sub.Sup&Deck  RH  0.0  27.4   7.12 

02456AUBL  0024  2  52  1997  9  Sub  RH  Sup  Repl  0.0  34.4   5.68 

03451  0331  4  50  1994  11  Sub&Sup  RH.Dk  RP  0.0  16.7  27.07 

03451  0331  4  50  1995  9  Sub  RH  Sup  Repl  0.0  15.8  28.56 

04540CSBL  1069  2  2  1994  15  Raise/Lower  Pvmt  0.0  49.9  10.63 

04540CSBL  1069  2  2  1996  12  Super  Replace  0.0  41.2  12.88 

04858AUBL  0024  2  52  2006  3  Super  &Deck  Rehab  0.0  142.9   7.63 

04858AUBL  0024  2  52  1996  1  Deck  Rehab  0.0  15.9  41.33 

04858AUBL  0024  2  52  1997  6  Sub&Deck  Rehab  0.0  14.8  44.62 

06934  0252  5  24  1994  5  Substruct  Rehab  0.0  10.8  10.75 


=====  Summary  ==== 

Records  Processed:  19 

Total  Errors     :  0 

Total  Cost  ($1000)  6492.7 

Total  EUAC  ($1000)  720.2 

Total  CEF  ($1000)  461.6 

AVE   Cost  ($1000)  341.7 

AVE   EUAC  ($1000)  37.9 

AVE   CEF  ($1000)  24.3 


Figure  G.5  COST  Normal  Report 
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RUNFILE:  test. run 


COST 


PROGRAM 


REPORT 


YEAR  OF  ANALYSIS:  1992 


Bridge 
num   des 


Route  i  Co.   Act   Act 
#    s  Code  Year  Code 


Action 


PU  1992        CEF   E 

Cost    EUAC   v/$/  x 

($1000)  $1000  1000f2  ? 


00652  0007  5  39  1994  16  Replace  0.0  20.8  25.64  F 

00899B  0024  4  56  1994  10  Sub&Sup  Rehab  0.0  8.2  126.26  F 

01083A  0056  5  78  1994  13  Uiden&Deck  Rehab  0.0  25.0  4.19  F 

01083A  0056  5  78  1995  14  Uiden&Deck  Repl  0.0  27.1  3.86  F 

01363A  0227  3  89  1994    1  Deck  Rehab  0.0  16.1  7.87  F 

01363A  0227  3  89  1995    2  Deck  Replace  0.0  26.4  4.80  F 

01363A  0227  3  89  1996    7  Sub  RH  Deck  Repl  0.0  24.4  5.18  F 

02431  1065  3  49  1994    4  Sup  RH  Deck  Repl  0.0  309.2  2.30  F 

02456AUBL  0024  2  52  1994    3  Super&Deck  Rehab  0.0  27.6  7.08  F 

02456AUBL  0024  2  52  1995    8  Sub.Sup&Deck  RH  0.0  27.4  7.12  F 

02456AUBL  0024  2  52  1997    9  Sub  RH  Sup  Repl  0.0  34.4  5.68  F 

03451  0331  4  50  1994  11  Sub&Sup  RH.Dk  RP  0.0  16.7  27.07  F 

03451  0331  4  50  1995    9  Sub  RH  Sup  Repl  0.0  15.8  28.56  F 

04540CSBL  1069  2  2  1994  15  Raise/Lower  Pvmt  0.0  49.9  10.63  F 

04540CSBL  1069  2  2  1996  12  Super  Replace  0.0  41.2  12.88  F 

04858AUBL  0024  2  52  1996    1  Deck  Rehab  0.0  15.9  41.33  F 

04858AWBL  0024  2  52  1997  6  Sub&Deck  Rehab  0.0  14.8  44.62  F 

06934  0252  5  24  1994    5  Substruct  Rehab  0.0  10.8  10.75  F 

=====  Summary  ==== 

Records  Processed:  19 

Total  Errors  :  0 


Total  Cost  ($1000)  5252.3 

Total  EUAC  ($1000)  720.2 

Total  CEF  ($1000)  461.6 

AVE   Cost  ($1000)  276.4 

AVE   EUAC  ($1000)  37.9 

AVE   CEF  ($1000)  24.3 


Figure  G.7  COST  Present  Worth  Report 


Table  G.3  Description  of  COST  Report 
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Heading 

Description 

Bridge  num  and  des 

Bridge  number  and  designation 

Route  # 

Route  number 

Dis 

District  code 

Co.  Code 

County  code 

Act  Year 

Action  year 

Act  Code 

Action  code 

Action 

Action 

1992  Cost  ($1000) 

Base  year  cost  converted  to  analysis  year 
dollars,  in  thousands 

EUAC  $1000 

Equivalent  uniform  annual  cost,  in  analysis 
year  dollars 

CEF  v/$/1000f2 

Cost  effectiveness  factor,  in 
vehicles/ $1000 /feet2 

Ex?  (T  or  F) 

T:  Exception  record  used 

F:  Exception  record  not  used 

Year1 

Year  of  next  repair  in  life  cycle 

Ac1 

Repair  code 

Yr  1992  Cost  ($1000)' 

Estimated  cost,  in  analysis  year  dollars 

PW  1992  Cost  ($1000)2 

Present  worth  of  repair,  in  analysis  year 
dollars 

1  These  items  appear  only  if  a  look  ahead  or  present  worth,  look  ahead 
report  style  is  specified. 

2  These  items  appear  only  if  a  present  worth  or  present  worth,  look 
ahead  report  style  is  specified. 
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Table  G.4  Description  of  RANK  Report 


Heading 

Description 

Bridge  num  and  des 

Bridge  number  and  designation 

Route  # 

Route  number 

Ds 

District  code 

Co.  Code 

County  code 

Act  Year 

Action  year 

Act  Code 

Action  code 

Action 

Action 

Cost  ($1000) 

Base  year  cost  converted  to  analysis  year 
dollars,  in  thousands 

EUAC  $1000 

Equivalent  uniform  annual  cost,  in  analysis 
year  dollars 

Ex?  (T  or  F) 

T:  Exception  record  used 

F:  Exception  record  not  used 

Util  Now 

Total  disutility  of  bridge  before  repair,  for 
action  year 

Util  Aftr 

Total  disutility  after  repair,  for  action 
year 

Dlta  Util 

Change  in  total  disutility  before  and  after 
repair,  for  action  year 

Cost  Eff.1 

Cost  effectiveness  disutility  function  value 

Rem.  Life1 

Remaining  life  disutility  function  value 

Strc  Cond1 

Structural  condition  disutility  function 
value 

Clr.  Deck1 

Clear  deck  width  disutility  function  value 

Vert  Clr.1 

Vertical  clearance  disutility  function  value 

Inv  Rtng1 

Inventory  rating  disutility  function  value 

Det.  Len.1 

Detour  length  disutility  function  value 

1  These  items  appear  only  if  a  utility  report  style  is  specified.   In 
addition,  these  values  represent  the  disutility  before  a  repair  is  made. 
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INDOT  BMS 


DECISION  TREE  LOG 


Runfile:   test.ruYEAR  OF  ANALYSIS:  1992 


Total  Records  Successfully  Processed  10 
Total  Errors  In  Processing  Records  0 
Decision         Count 


Nothing 
Deck  Rehab 
Deck  Replace 
Super&Deck  Rehab 
Sup  RH  Deck  Repl 
Substruct  Rehab 
Sub&Deck  Rehab 
Sub  RH  Deck  Repl 
Sub.Sup&Deck  RH 
Sub  RH  Sup  Repl 
Sub&Sup  Rehab 
Sub&Sup  RH.Dk  RP 
Super  Replace 
Uiden&Deck  Rehab 
Widen&Deck  Repl 
Raise/Lower  Pvmt 
Replace 


Figure  G.10  DTREE  Log  File 


RUNFILE:  test. run 


COST 


PROGRAM 


LOG 


YEAR  OF  ANALYSIS:  1992 


Processing  input  records... 

=====  Summary  ==== 

Records  Processed:-  19 

Total  Errors     :  0 

Total  Cost  ($1000)  6492.3 

Total  EUAC  ($1000)  720.7 

Total  CEF  ($1000)  461.6 

AVE   Cost  ($1000)  341.7 

AVE   EUAC  ($1000)  37.9 

AVE   CEF  ($1000)  24.3 


Figure  G.ll  COST  Log  File 
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RUNFILE:  test. run       RANK     PROGRAM     LOG        YEAR  OF  ANALYSIS:  1992 

SelectOneAction.T. :    18  actions.    10  selected  and     8  rejected. 
GetADTStats:  0  errs,   10  ADTEs  used  to  compute  mean=27.020     stdev=37.299 


Figure  G.12  RANK  Log  File 
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December  4,  1991 

BMS  -  MR  &  R  ACTIVITIES 


COST  ESTIMATES: 

The  Purdue  cost  study  determined  algorithms  or  cost  basis 
for  projects  of  "Bridge  Replacement",  "Deck 
Rehabilitation",  and  "Deck  Replacement".  The  bridge  work 
category  includes  other  rehabilitation  or  reconstruction 
activities  than  these  studied  so  a  cost  basis  for  the 
other  activities  must  be  developed.  Without  performing 
a  cost  study  and  to  proceed  with  the  implementation  phase 
of  the  Bridge  Management  System,  an  expert  opinion  poll 
was  conducted  to  determine  present  default  cost  estimates 
for  the  other  activities.  A  cost  study  will  be  performed 
in  the  future  and  the  default  values,  will  be  replaced 
with  determined  algorithms.  The  expert  group  estimating 
the  cost  default  values  consisted  of  Jack  White,  Jim 
Karr,  Danny  Wampler,  and  Robert  Woods.  The  estimated 
default  values  for  each  rehabilitation/reconstruction 
activity  is  as  follows: 

1.  Deck  Rehabilitation 

Use  cost  estimate  basis  as  determined  by  the 
Purdue  study. 

2 .  Deck  Replacement 

Use  cost  estimate  basis  as  determined  by  the  Purdue 
study . 

3.  Superstructure  Rehab  plus  Deck  Rehabilitation 

Use  cost  estimate  basis  as  determined  by  #1  -  Deck 
Rehabilitation  listed  above  and  increase  five  (5) 
percent. 

4 .  Superstructure  Rehab  plus  Deck  Replacement 

Use  cost  estimate  basis  as  determined  by  #2  -  Deck 
Replacement  listed  above  and  increase  five  (5) 
percent. 

5.  Substructure  Rehabilitation 

Use  a  constant  $25,000 

6.  Substructure  Rehab  plus  Deck  Rehabilitation 

Use  cost  estimate  basis  as  determined  by  #1  -  Deck 
Rehabilitation  listed  above. 

7.  Substructure  Rehab  plus  Deck  Replacement 

Use  cost  estimate  basis  as  determined  by  #2  -  Deck 


187 
Replacement  listed  above. 

8.  Substructure,  Superstructure,  and  Deck  Rehabilitation 

Use  cost  estimate  basis  as  determined  by  #1  -  Deck 
Rehabilitation  listed  above  and  increase  twenty- 
five  (25)  percent. 

9.  Substructure    Rehabilitation    and    Superstructure 
Replacement 

Use  cost  estimate  basis  as  determined  by  the  Purdue 
study  for  a  bridge  replacement  project. 

10.  Substructure    Rehabilitation    plus    Superstructure 
Rehabilitation 

Use  cost  estimate  basis  as  determined  by  #1  -  Deck 
Rehabilitation  listed  above  and  increase  ten  (10) 
percent. 

11.  Substructure  Rehab,   Superstructure   Rehab   plus   Deck 
Replacement 

Use  cost  estimate  basis  as  determined  by  #4  - 
Superstructure  Rehabilitation  plus  Deck  Replacement 
listed  above  and  increase  five  (5)  percent. 

12 .  Superstructure  Replacement 

Use  cost  estimate  basis  as  determined  by  the  Purdue 
study  for  a  bridge  replacement  project  minus  the 
substructure  cost  and  minus  6  0  percent  of  the 
approach  cost. 

13.  Bridge  Widening  plus  Deck  Rehabilitation 

Use  60  percent  of  the  cost  estimate  basis  as 
determined  by  the  Purdue  study  for  a  bridge 
replacement  project. 

14.  Bridge  Widening  plus  Deck  Replacement 

Use  80  percent  of  the  cost  estimate  basis  as 
determined  by  the  Purdue  study  for  a  bridge 
replacement  project. 

15.  Raise  Bridge/Lower  Pavement 
Use  a  constant  $350,000 

16.  Bridge  Replacement 

Use  cost  estimate  basis  as  determined  by  the  Purdue 
study. 

17 .  Culvert  Replacement 

Use  a  constant  $200,000 
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Table  H.l  Action  Code  Definitions 


Action  Code 

Action 

1 

Deck  Rehabilitation 

2 

Deck  Replacement 

3 

Superstr  Rehab  +  Deck  Rehab 

4 

Superstr  Rehab  +  Deck  Replacement 

5 

Substr  Rehab 

6 

Substr  Rehab  +  Deck  Rehab 

7 

Substr  Rehab  +  Deck  Replacement 

8 

Substr,  Superstr  and  Deck  Rehab 

9 

Substr  Rehab  +  Superstr  Replacement 

10 

Substr  Rehab  +  Superstr  Rehab 

11 

Substr  Rehab,  Superstr  Rehab  +  Deck 
Replacement 

12 

Superstructure  Replacement 

13 

Bridge  Widening  +  Deck  Rehabilitation 

14 

Bridge  Widening  +  Deck  Replacement 

15 

Raise  Bridge/Lower  Pavement 

16 

Bridge  Replacement 

17 

Culvert  Replacement 

APPENDIX  I  COMPILING  THE  PROGRAMS 
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1.1  COMPILING  FORTRAN  PROGRAMS 

If  modifications  are  made  to  any  of  the  programs,  the 
programs  must  be  re-compiled.  It  is  recommended  that  all  four 
programs  be  re-compiled,  since  some  of  the  routines  are  used 
by  more  than  one  program;  for  example,  DEGRADE. FOR  is  used  by 
both. 

A  file  called  MAKEFILE  has  been  set  up  to  simplify  the 
compiling  process;  see  Figure  1.1.  This  file  establishes  the 
necessary  program  and  library  links  and  parameters  used  by  the 
programs.  The  makefile  is  used  in  conjunction  with  a  program 
called  NMAKE.EXE,  which  is  a  utility  program  in  Microsoft  C, 
version  6.0. 

To  compile  and  the  user  must  be  in  the  directory 
\bridge\prog\source\fortran.  At  the  prompt,  type  "nmake"  and 
the  program  name.  For  example,  to  compile  dtree,  type  "nmake 
dtree."  After  compilation  is  finished,  the  new  executable 
file  (i.e.,  DTREE.EXE)  must  be  copied  to  the  directory 
\bridge\prog.  Another  alternative  would  be  to  compile  the 
three  programs  simultaneously.  A  batch  file  called 
COMPILE.CMD  has  been  created,  which  compiles  all  three 
programs  and  then  copies  the  executable  files  to  the 
appropriate  directory;  simply  type  "compile"  at  the  prompt. 

1.2  Compiling  C  Programs 
The  majority  of  the  programs  found  in  the  IBMS  Tools  are 
written  in  Microsoft  C.   When  modifications  are  made  to  these 
programs,  the  program  Programmer's  Workbench  (pwb.exe)  can  be 
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used,  which  is  a  utility  program  in  Microsoft  C. 

To  compile  a  program,  the  user  must  be  in  the  directory 
\bridge\prog\source\c.  Type  "pwb"  at  the  prompt  and  open  the 
appropriate  program.  First,  make  sure  that  the  library  is  set 
for  OS/2,  by  pressing  Alt-0  for  the  Options  menu,  and  then  C 
for  C  Compiler  Options;  under  C  Libraries,  highlight  OS/2  with 
the  mouse. 

After  making  modifications,   compile  the  program  by 
pressing  Alt-M  for  the  Make  menu  and  then  R  for  Rebuild  All. 
Exit  pwb.exe  by  pressing  Alt-F4  and  then  copy  the  new 
program  (.exe)  to  the  directory  \bridge\prog. 
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#  Makefile  for  FORTRAN  programs  on  the  PC 

.SUFFIXES:  .for 
ff=fortran 

#  Rule  to  make  a  FORTRAN  program 

.for.obj: 

$(ff)  $*.for  $(FFLAGS) 

#  Fortran  flags 
# 

FFLAGS  =  /n  /y  /L  >  out 

#  Macros  to  link  fortran  programs  with 
FLIB=c:\fortran\plib\fortrae.lib 
FLIBDOS=c:\fortran\rlib\fortrae.lib 

L=/PMTYPE:NOVIO 
M=/PMTYPE:VIO 

#  Head  of  path  for  common  blocks 
# 

c  =  \bridge\common 

#  MACROS  , 
# 

costl  -   bdata.obj 

cost2  =  cost.obj  costest.obj  econ.obj  error. obj  extend. obj 

cost3  =  getbridg.obj  map. obj  readcost.obj  readdoll.obj  readlife.obj 

cost4  =  misc. obj 

cost 5  =  ski p. obj  readrun.obj 

costol  =  $c\run.cmn  $c\bridge.cmn  $c\costinp.cmn  $c\map.cmn  $c\unit.cmn 
costo2  =  $c\dollar.cmn  $c\option.cmn  $c\unit.cmn  $c\life.cmn 
costo3  =  $c\linfo.cmn  $c\costout.cmn  $c\text.cmn  $c\option.cmn 

dtreel  =  dtree.obj  error. obj  getbridg.obj  getdecis.obj  getex.obj 

dtree2  =  readrun.obj  readtree.obj  findend.obj  readdoll.obj 

dtree3  =  econ.obj  degrade. obj 

dtreeA  =  misc. obj  bdata.obj 

dtree5  =  map. obj  skip. obj  costest.obj 

dtreeol  =  $c\except.cmn  $c\dtreeout.cmn  $c\dtreeout.cmn  $c\option.cmn 
dtreeo2  =  $c\run.cmn  $c\bridge.cmn  $c\text.cmn  $c\unit.cmn  $c\dollar.cmn 

rankl  =  rank. obj  error. obj  readrun.obj  readwt.obj  readutil.obj    misc. obj 
rank2  =  econ.obj  utility. obj  skip. obj  getbridg.obj  readdoll.obj  map. obj 
rank3  =  bdata.obj  degrade. obj  extend. obj 
rank4  =  compute. obj  delta. obj 

rankol  =  $c\unit.cmn  $c\option.cmn  $c\run.cmn  $c\dol lar.cmn  $c\rankbuf .cmn 
ranko2  =  $c\bridge.cmn  $c\rankout.cmn  $c\rankinp.cmn  $c\text.cmn 

prbrid  =  map. obj  error. obj  getbridg.obj  prbridge.obj  bdata.obj  misc. obj 

prexe  =  printexe.obj  error. obj  getex.obj  bdata.obj  misc. obj 

zoom5  =  zooml.obj  zomaps.obj  zdrive.obj  zolp.obj  hpsort.obj  zoheur.obj 
zoom2  =  zobab.obj  zinc. obj  zmisc.obj  zfeas.obj  ztour.obj  zpandc.obj  mpsw.obj 
zoom3  =  zospec.obj  xlpl.obj  xlp2.obj  xlp3.obj  xdualsm.obj  xdata.obj  xrang.obj 
zoom4  =  ildata.obj  xpara.obj  la05.obj  xlp4.obj 

optl  =  optmain.obj  makecmn.obj  deter. obj  ures.obj  rrdata.obj  inxmp.obj 
opt2  =  xml2.obj  hpsort.obj  lopen.obj 

putlOO  =  putlOO.obj 

Figure  1.1  Makefile 
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#  Main  Programs 
# 

chop:  chop.obj  misc.obj 

link  $1  chop.obj  misc.obj  ,  chop.exe,  map. out,  $(FLIB),  nul .def ;cost:  $(cost1)  $(cost2) 
$(cost3)  $(cost4)  $(cost5) 

link  $t  /SE:200  $(cost1)  $(cost2)  $(cost3)  $(cost4)  $(cost5),  cost.exe,  map. out,  $(FLIB), 

nul .def; 
dtree:  $(dtree1)  $(dtree2)  $(dtree3)  $(dtree4)  $(dtree5) 

link  $1  /SE:200  $<dtree1)  $(dtree2)  $(dtree3)  $<dtree4)  $(dtree5),  dtree.exe,  map. out, 

$(FLIB),  nul. def; 

prbridge:  $(prbrid) 

link  $L  S(prbrid),  prbridge.exe,  map. out,  $(FLIB),  nul. def; 

printexe:  $(prexe) 

link  $L  $(prexe)  ,  printexe.exe,  map. out,  $(FLIB),  nul. def; 

rank:  $(rank1)  $(rank2)  $(rank3)  $(rank4) 

link  $L  /SE:200  $(rank1)  $(rank2)  $(rank3)  $(rank4),rank.exe,  map. out,  $(FLIB),  nul. def; 

zoom:  $(zoom5)  $(zoom2)  $(zoom3)  $(zoom4) 

link  $L  /SE:300  S(zoom5)  S(zoom2)  $(zoom3)  $(zoom4),  zoom.exe,  map. out,  $(FLIB),  nul. def; 

opt:  $(opt1)  $(opt2) 

link  SL  /SE:200  $(opt1)  $(opt2),  opt.exe,  map. out,  S(FL1B),  nul. def ; 

putlOO:  $(put100) 

link  $L  $(put100),  put100.exe,  map. out,  $(FLIB),  nul. def; 

#  Program  Modules 
# 

#  bcost.obj:  $c\cost.cmn 

bdata.obj:  $c\dollar.cmn  $c\dtree.cmn  $c\life.cmn  $c\map.cmn  \ 
$c\run.cmn  $c\uti lity.cmn  $c\weight.cmn 

#  bdollar.obj:  $c\dollar.cmn 

#  bdtree.obj:  $c\dtree.cmn 

#  blife.obj:  $c\life.cmn 

#  bmap.obj:  Sc\map.cmn 

#  brun.obj:  $c\run.cmn 

#  buti lity.obj:  $c\uti lity.cmn 

#  bweight.obj:  $c\ueight.cmn 

compute. obj:  $c\bridge.cmn  $c\rankinp.cmn  $c\weight.cmn 

cost.obj:  $(costo1)  $(costo2)  $(costo3) 

costest.obj:  $c\cost.cmn  $c\map.cmn  ScXbridge.cmn  $c\life.cmn 

degrade. obj:  $c\pmatrix.cmn  $c\bridge.cmn  $c\map.cmn 

delta. obj:  $c\delta.cmn 

dtree. obj:  $(dtreeo1)  $(dtreeo2) 

econ.obj:  $c\dol lar.cmn  $c\life.cmn  $c\bridge.cmn  $c\map.cmn 

error. obj:  $c\global .cmn  $c\option.cmn  $c\unit.cmn 

Figure  1.1,  continued 
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extend. obj:  $c\bridge.cmn  $c\costinp.cmn  $c\map.cmn 

#  findend.obj:  nothing 

getbridg.obj:  $c\bridge.cmn  $c\unit.cmn 

get dec  is. obj :  $c\bridge.cmn  $c\dtree.cmn 

getex.obj:  Sc\except.cmn 

map. obj:  $c\bridge.cmn  $c\map.cmn 

printexe.obj:  Sc\except.cmn  $c\unit.cmn 
$(ff)  printexe.for  $(FFLAGS)  /U 

prbridge.obj:  $c\bn'dge.cmn 

rank. obj:  $(ranko1)  $(ranko2) 

readcost.obj:  Sc\cost.cmn 

readdoll.obj:  $c\dol lar.cmn 

readlife.obj:  $c\life.cmn 

readrun.obj:  $c\run.cmn 

readtree.obj:  $c\dtree.cmn 

readwt.obj:  $c\ueight.cmn 

readuti l.obj:  $c\uti lity.cmn 

#skip.obj:  nothing 

utility. obj:  $c\uti lity.cmn 

makecmn.obj:  $c\f i ledir.cmn 

optmain.obj:  $c\f i ledir.cmn 

ures.obj:  $c\fi ledir.cmn 

rrdata.obj:  $c\fi ledir.cmn 


Figure  1.1,  continued 


Appendix  J  Subroutine  and  Function  Definitions 
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Table  J.l  Subroutine  Definitions 


Subroutine 

Program 
(.for) 

Description 

ComputeRanks 

compute 

calculates  total 
disutility  before  and 
after  repair,  as  well 
as  2,3,4,  and  5  years 
from  analysis  year 

GetUtilities 

compute 

calculates 

disutilities  for  each 
disutility  function 

Norma 1 i  z  eWe  ight s 

compute 

normalizes  weights  so 
that  they  sum  to  1.0 

Cycle 

cost 

computes  costs  for  one 
life  cycle 

EuacEtc 

cost 

calculates  equivalent 
uniform  annual  cost 
(EUAC)  and  cost 
effectiveness  factor 
(CEF) 

FullCycle 

cost 

uses  life  cycle  model 
to  determine  what 
repairs  should  be  done 
and  when 

MakeCostReports 

cost 

formats  data  for 
output  files 

PrintCostHeaders 

cost 

prints  headers  for 
reports 

QuitCost 

cost 

closes  files  and  exits 

WriteCostReports 

cost 

writes  reports  to 
files  (.out,  .txt, 
.log,  .prn) 

Wr it eCost Summary 

cost 

prints  summary  of 
program  execution 

C  opyMa t r  i  xRowT  oP 

degrade 

copies  selected  row 
from  GetPMatrix  to  P 

Degrade 

degrade 

uses  Markovian  process 
to  estimate  condition 
numbers  after 
inspection  year 
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Table  J.l,    continued 


Subroutine 

Program 
(.for) 

Description 

GetPMatrix 

degrade 

selects  transition 
matrix,  based  on  age, 
material,  and  function 
class 

MultQbyP 

degrade 

multiplies  vector  Q  by 
P 

Over lay Exlon2 

dtree 

if  information  in 
primary  exception 
record  (except. cmn)  is 
0,  information  from 
secondary  exception 
record  ( except 2 . cmn ) 
is  used 

PrintDtreeHeaders 

dtree 

prints  headers  for 
reports 

QuitDtree 

dtree 

closes  files  and  exits 

RestoreException 

dtree 

restores  exception 
records  from  buffer 

SaveException 

dtree 

stores  exception 
records  in  buffer 

SelectDecisions 

dtree 

saves  repair  code  only 
when  it  occurs  for 
first  time 

WriteDtreeReports 

dtree 

writes  reports  to 
files  (.out,  .txt, 
.log,  .prn) 

WriteDtreeSummary 

dtree 

prints  summary  of 
program  execution 

LogError 

error 

prints  errors  found  in 
/global/  block 

LogMessage 

error 

writes  errors  to  log 
file  (.log) 

SetError 

error 

sets  global  error 
message  and  code  f-»r 
main  programs 
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Table  J.l,  continued 


Subroutine 

Program 
(.for) 

Description 

LengthenBridge 

extend 

extends  bridge  length 
by  exception  record  or 
EstNewLength  function 

WidenBridge 

extend 

extends  bridge  width 
by  exception  record  or 
EstNewWidth  function 

ListErrors 

getbridg 

writes  errors  to  log 
file  (.log) 

MapRecord 

map 

replaces  fields  in 
bridge  record  with 
values  recognized  by 
program 

PutLine 

misc 

determines  length  of  a 
line  for  reports 

StripPathHead 

misc 

removes  full  path  name 
for  report  printing 

PrintBridgeHeader 

prbridge 

prints  headers  for 
report 

PrintExceptionHeader 

printexe 

prints  headers  for 
report 

WriteExceptionReport 

printexe 

prints  report  for 
exception  records 

CopyRanklnputToBuf  f  er 

rank 

copies  data  from 
rankinp.cmn  to 
rankbuf . cmn 

MakeRankReports 

rank 

formats  data  for 
output  files 

PrintRankHeaders 

rank 

prints  headers  for 
reports 

QuitRank 

rank 

closes  files  and  exits 

WriteRankReports 

rank 

writes  reports  to 
files  (.out,  .txt, 
.log,  .prn) 
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Table  J.l,    continued 


Subroutine 

Program 
(.for) 

Description 

WriteRankSummary 

rank 

prints  summary  of 
program  execution 

Tack 

readrun 

splices  character 
strings  together  to 
eliminate  blanks 

Skip 

skip 

skips  n  number  of 
lines  when  reading  a 
file 
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Table  J. 2  Function  Definitions 


Function 

Program 
(.for) 

Description 

GetRank 

compute 

computes  bridge's 
total  disutility 
based  on  condition 
numbers,  bridge 
properties,  and 
recommended  repair 

Costlnit 

cost 

opens  and  reads 
files  needed  for 
program  execution 

GetNextCostlnput 

cost 

reads  next  bridge 
record 

GetPW 

cost 

computes  present 
worth  of  repairs  and 
maintenance  costs 

Rehab 

costest 

calculates 
rehabilitation 
costs,  based  on  deck 
area  and  patching 
percentage 

RepairCost 

costest 

calculates  cost,  in 
$1000's,  for 
recommended  repair 

Replace 

costest 

calculates 
replacement  cost, 
assuming  100' 
approach  length 

YearlyMaintCostEst 

costest 

estimates  yearly 
maintenance  cost 

QTimesRTranspose 

degrade 

multiplies  vector  Q 
by  transpose  of  [9  8 
7  6  5  4  3] 

DeltaDeckCondition 

delta 

represents  the 
change  in  deck 
condition  after  a 
repair 
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Table  J. 2,    continued 


Function 

Program 
(.for) 

Description 

DeltaServiceLife 

delta 

represents  the 
change  in  service 
life  after  a  repair 

DeltaSubCondition 

delta 

represents  the 
change  in 
substructure 
condition  after  a 
repair 

DeltaSuperCondition 

delta 

represents  the 
change  in 
superstructure 
condition  after  a 
repair 

Dtreelnit 

dtree 

opens  and  reads 
files  needed  for 
program  execution 

BaseYrToYr 

econ 

converts  dollars 
from  base  year  to 
specified  year 
(typically  the 
analysis  year) 

MaintCost 

econ 

determines  the 
maintenance  costs 
for  the  life  cycle 
model 

PerpetualWorth 

econ 

computes  the  life 
cycle  cost  in 
perpetuity 

PresentWorth 

econ 

calculates  the 
present  worth  of 
costs 

PresentWorthMaint 

econ 

determines  the 
present  worth  of 
maintenance  costs 

PWGradient 

econ 

calculates  a 
gradient  cost  for 
maintenance 
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Table  J. 2,  continued 


Function 

Program 
(.for) 

Description 

UniformCost 

econ 

calculates  uniform 
annual  cost  for 
maintenance 

YearToYear 

econ 

converts  dollars 
from  one  year  to 
another 

YrToBaseYr 

econ 

converts  dollars 
from  specified  year 
to  base  year 

EstNewLength 

extend 

estimates  new  bridge 
length  after  a 
replacement 

EstNewWidth 

extend 

estimates  new  clear 
deck  width 

FutureADT 

extend 

estimates  future 
average  daily 
traffic 

FindEnd 

f indend 

finds  end  of  file 

CheckRec 

getbridg 

checks  bridge 
records  for  errors 

FindMatch 

getbridg 

finds  matching 
bridge  record 

GetNextBridge 

getbridg 

reads  next  bridge 
record 

PrintBridge 

getbridg 

prints  bridge 
records 

GetDecision 

getdecis 

uses  decision  tree 
to  recommend  a 
repair 

CheckExceptionFile 

getex 

checks  to  see  if 
file  is  sorted  and 
entries  are  in 
correct  format 
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Table  J. 2,    continued 


Function 

Program 
(.for) 

Description 

GetException 

getex 

loads  exception 
records,  if 
available 

GetExceptionlndex 

getex 

finds  location  of 
bridge  number  record 
that  corresponds  to 
bridge  number  key- 
passed  to  the 
routine 

GetNextException 

getex 

reads  next  exception 
record 

IsRehab 

map 

determines  if  repair 
code  is  a 
rehabilitation 

IsReplace 

map 

determines  if  repair 
code  is  a  replace 

IsWiden 

map 

determines  if  repair 
code  affects  bridge 
width 

MapApplen 

map 

uses  default 
approach  length  if 
none  specified 

MapFunctClass 

map 

converts  functional 
class  of  bridge  to 
one  used  by  program 

MapSST 

map 

determines 
superstructure  type; 
currently  not  used 

MapSuperConst 

map 

converts 

superstructure  type 
code  to  one  used  by 
program 

MapSuperMaterial 

map 

converts 
superstructure 
material  code  to  one 
used  bj  program 
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Table  J. 2,  continued 


Function 

Program 
(.for) 

Description 

MapVClear 

map 

uses  default 
vertical  clearance 
if  none  specified 

MapWorkProposed 

map 

converts  "work 
proposed"  field  to  a 
code  recognized  by 
program 

MapYearBuilt 

map 

stores  most  recent 
repair  year 

GetADTStats 

rank 

computes  mean  and 
standard  deviation 
for  cost 
effectiveness  factor 

GetNextRanklnput 

rank 

reads  next  record 
from  rank  input  file 
to  rankinp.cmn 
buffer 

Ranklnit 

rank 

opens  and  reads 
files  needed  for 
program  execution 

SelectOneActionPerBridge 

rank 

if  more  than  one 
repair  is 

recommended,  repair 
with  lowest  EUAC  is 
selected 

WriteRanklnputBuffer 

rank 

writes  information 
from  rankbuf . cmn 
block  to  unit  u 

ReadCostParam 

readcost 

reads  parameters  for 
estimating  repair 
costs 

ReadDollarTable 

readdoll 

reads  dollar 
conversion  data 

ReadLifeCycle 

readlife 

reads  parameters  for 
life  cycle  cost 
model 
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Table   J.  2,    continued 


Function 

Program 
(.for) 

Description 

ReadRunFile 

readrun 

loads  input  and 
output  file  names 
and  options 

ReadTree 

readtree 

loads  parameters  for 
decision  tree 

ReadUtility Functions 

readutil 

reads  parameters 
used  for  disutility 
functions 

ReadWeights 

readwt 

loads  weights  used 
for  project  ranking 

ClearDeckWidthFunction 

utility 

computes  disutility 
based  on  clear  deck 
width 

Detour LengthFunct ion 

utility 

computes  disutility 
based  on  detour 
length  or  cost  of 
temporary  run-around 

Ef fectiveWFactor 

utility 

computes  economic 
effectiveness  factor 

OperatingRatingFunction 

utility 

computes  disutility 
based  on  operating 
rating  (in  tons) 

OverallRank 

utility 

computes  total 
disutility  for 
bridge 

RemainingLifeFactor 

utility 

computes  disutility 
based  on  remaining 
service  life 

StructuralConditionFactor 

utility 

computes  disutility 
based  on  minimum 
condition  number 
from  deck, 
substructure ,  and 
superstructure 
condition 

Vert icalClearanceFunct ion 

utility 

computes  disutility 
based  on  vertical 
clearance 

z  I 

a 

o 

c 


